by 0xranx
A personal context store for AI agents and assistants—reuse your existing coding agent CLI (Codex/Claude/OpenCode) with built‑in Skills/tools and a desktop GUI to capture, search, and reuse project knowledge across agents and repos.
# Add to your Claude Code skills
git clone https://github.com/0xranx/OpenContextWhen you use an AI assistant to build things, context gets lost (across days, repos, chats). You end up re-explaining background, repeating decisions, and sometimes the assistant continues with the wrong assumptions. Most tools stop at storage and don't plug into the coding agent you already use.
OpenContext is a lightweight personal context / knowledge store for AI assistants (Agents) and coding tools like Cursor / Claude Code / Codex. It reuses your existing coding agent CLI (Codex/Claude/OpenCode) while adding a GUI plus built-in Skills/tools, so your agent can "load history first, then act; ship, then persist".
Skills-first support: oc init generates user-level skills (Cursor/Claude Code/Codex) plus slash commands (Cursor/Claude Code), so agents can load, search, create, and iterate your context with one command.
| Before OpenContext | After OpenContext | |-------------------|-------------------| | 📂 Hard to share context across repos/sessions | ✅ Global context library works across all projects | | 🤷 Your ideas can't be quickly perceived by Agent | ✅ Agent loads your background & decisions automatically | | 🔒 Existing knowledge can't be operated by Coding Agent | ✅ Agent can directly read/write your knowledge base |
oc CLI — manage a global contexts/ library (folders/docs, manifests, search)oc init)OpenContext's knowledge management Agent can be the coding agent you already use (Codex/Claude/OpenCode). You don't pay for a separate agent — you bring your own CLI and get a ready-to-use experience: a GUI for context management plus built-in Skills and tools that let the agent read, search, create, and iterate on your knowledge.
npm install -g @aicontextlab/cli
| Path | Best For | Get Started |
|------|----------|-------------|
| 🖥️ Desktop App | Visual users who want a native UI | Download from Releases |
| ⌨️ CLI + Tools | Developers using Cursor/Claude Code/Codex/AI agents | npm install -g @aicontextlab/cli && oc init |
| 🔧 CLI Only | Power users, automation | npm install -g @aicontextlab/cli |
OpenContext works with the coding agent CLI you already have — it adds a GUI plus built-in Skills/tools instead of replacing your agent.
# 1. Install
npm install -g @aicontextlab/cli
# 2. Initialize (prompts for tool setup; defaults to all)
cd your-project
oc init
# 3. Use slash commands (Cursor + Claude Code)
# /opencontext-context — load background before working
# /opencontext-search — find relevant docs
# /opencontext-create — create a new doc
# /opencontext-iterate — persist what you learned
# Tip: non-interactive installs can use --tools cursor,claude,codex or --no-claude/--no-cursor/--no-codex
#
# Installed by oc init:
# - Cursor: ~/.cursor/commands
# - Claude Code: ~/.claude/commands (or $CLAUDE_CONFIG_DIR/commands)
# Skills (wrapped from slash commands):
# - Cursor: ~/.cursor/skills/opencontext-*/SKILL.md
# - Claude Code: ~/.claude/skills/opencontext-*/SKILL.md (or $CLAUDE_CONFIG_DIR/skills)
# - Codex: ~/.codex/skills/opencontext-*/SKILL.md (or $CODEX_HOME/skills)
#
# 4. MCP config is user-level (Cursor/Claude Code/Codex)
# - Cursor: ~/.cursor/mcp.json
# - Claude Code: ~/.claude/mcp.json (or $CLAUDE_CONFIG_DIR/mcp.json)
# - Codex: ~/.codex/mcp.json (or $CODEX_HOME/mcp.json)
📖 For detailed usage guide, search configuration, and FAQ, visit the Website.
Run oc <cmd> --help for details.
| Command | What it does |
|---------|--------------|
| oc init | Initialize OpenContext + user-level tool integrations |
| oc folder ls | List folders |
| oc folder create <path> -d "desc" | Create a folder |
| oc doc create <folder> <name>.md -d "desc" | Create a document |
| oc doc ls <folder> | List documents |
| oc context manifest <folder> | Generate file list for AI to read |
| oc search "query" | Search documents |
| oc mcp | Start MCP server for MCP clients |
| oc ui | Start local Web UI |
📖 Full command reference available on the Website.
# Clone & install
git clone https://github.com/0xranx/OpenContext.git
cd OpenContext && npm install
# Desktop app
npm run tauri:dev # development
npm run tauri:build # production build
# Web UI
npm run ui:dev # development
npm run ui:build # production build
MIT © OpenContext
No comments yet. Be the first to share your thoughts!