{"id":"f1838e5c-d8e8-4046-a899-5e974808afe7","slug":"0xranx-opencontext","kind":"mcp","name":"OpenContext","summary":"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 kn","owner":"0xranx","repoUrl":"https://github.com/0xranx/OpenContext","license":"MIT","licenseTier":"permissive","trust":"community","stars":1268,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-12-17T09:05:19.000Z","addedAt":"2026-10-14T05:36:25.541Z","logoUrl":"https://avatars.githubusercontent.com/u/201130212?u=a9ee291979a1093c58a4f6e377732684ea2b037e&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["memory-knowledge","search","developer-tools"],"tags":["agent","ai","ai-agents","claude-code","cli","codex","context","context-management"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T05:48:42.061Z","sample":false,"url":"https://conduits.dev/tools/0xranx-opencontext","language":"JavaScript","transports":["stdio"],"install":{"npm":"@aicontextlab/cli"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<div align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"docs/images/logo-dark.png\">\n    <source media=\"(prefers-color-scheme: light)\" srcset=\"docs/images/logo-light.png\">\n    <img alt=\"OpenContext Logo\" src=\"docs/images/logo-light.png\" width=\"350\">\n  </picture>\n\n  <p>\n    <strong>Give your AI assistant a persistent memory.</strong><br>\n    Stop repeating yourself. Start building smarter.\n  </p>\n\n  <p>\n    <strong>Bring your own coding agent.</strong> OpenContext reuses your existing CLI (Codex/Claude/OpenCode) and adds a GUI + built-in Skills/tools — no extra agent subscription.\n  </p>\n\n  <table>\n    <tr>\n      <td>\n        <img src=\"docs/images/overview.png\" alt=\"OpenContext Overview\" height=\"260\">\n      </td>\n      <td>\n        <img src=\"docs/images/folder-refer-git.gif\" alt=\"OpenContext Demo\" height=\"260\">\n      </td>\n    </tr>\n  </table>\n\n  <p>\n    <a href=\"https://www.npmjs.com/package/@aicontextlab/cli\"><img src=\"https://img.shields.io/npm/v/@aicontextlab/cli.svg?style=flat-square&color=cb3837\" alt=\"npm version\"></a>\n    <a href=\"https://github.com/0xranx/OpenContext/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/0xranx/OpenContext?style=flat-square\" alt=\"license\"></a>\n  </p>\n\n  <p>\n    <a href=\"https://0xranx.github.io/OpenContext/en/\"><strong>🌐 Website</strong></a> · \n    <a href=\"https://0xranx.github.io/OpenContext/en/usage/\"><strong>📖 Usage Guide</strong></a> · \n    <a href=\"https://github.com/0xranx/OpenContext/releases\"><strong>⬇️ Download Desktop</strong></a>\n  </p>\n\n  <p><a href=\"README.zh-CN.md\">中文文档</a></p>\n</div>\n\n---\n\n## The Problem\n\nWhen 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.\n\n## The Solution\n\nOpenContext 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\".\n\n**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.\n\n| Before OpenContext | After OpenContext |\n|-------------------|-------------------|\n| 📂 Hard to share context across repos/sessions | ✅ Global context library works across all projects |\n| 🤷 Your ideas can't be quickly perceived by Agent | ✅ Agent loads your background & decisions automatically |\n| 🔒 Existing knowledge can't be operated by Coding Agent | ✅ Agent can directly read/write your knowledge base |\n\n## What's Included\n\n- **`oc` CLI** — manage a global `contexts/` library (folders/docs, manifests, search)\n- **MCP Server** — so Cursor/Claude Code/Codex/Agents can call OpenContext as tools\n- **Skills + Slash Commands** — user-level skills for Cursor/Claude Code/Codex and slash commands for Cursor/Claude Code (generated by `oc init`)\n- **Agent-ready Knowledge Layer** — reuse your existing coding agent CLI (Codex/Claude/OpenCode) with built-in skills/tools and GUI\n- **Desktop App** — manage/search/edit contexts with a native UI\n- **Web UI** — browse/edit contexts locally (no install required)\n\n## Why OpenContext for Builders\n\nOpenContext'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.\n\n## Quick Start\n\n### Install CLI\n\n```bash\nnpm install -g @aicontextlab/cli\n```\n\n### Choose Your Path\n\n| Path | Best For | Get Started |\n|------|----------|-------------|\n| 🖥️ **Desktop App** | Visual users who want a native UI | [Download from Releases](https://github.com/0xranx/OpenContext/releases) |\n| ⌨️ **CLI + Tools** | Developers using Cursor/Claude Code/Codex/AI agents | `npm install -g @aicontextlab/cli && oc init` |\n| 🔧 **CLI Only** | Power users, automation | `npm install -g @aicontextlab/cli` |\n\nOpenContext works with the coding agent CLI you already have — it adds a GUI plus built-in Skills/tools instead of replacing your agent.\n\n### 30-Second Setup (CLI + Cursor/Claude Code/Codex)\n\n```bash\n# 1. Install\nnpm install -g @aicontextlab/cli\n\n# 2. Initialize (prompts for tool setup; defaults to all)\ncd your-project\noc init\n\n# 3. Use slash commands (Cursor + Claude Code)\n#    /opencontext-context  — load background before working\n#    /opencontext-search   — find relevant docs\n#    /opencontext-create   — create a new doc\n#    /opencontext-iterate  — persist what you learned\n#    Tip: non-interactive installs can use --tools cursor,claude,codex or --no-claude/--no-cursor/--no-codex\n#\n#    Installed by oc init:\n#    - Cursor: ~/.cursor/commands\n#    - Claude Code: ~/.claude/commands (or $CLAUDE_CONFIG_DIR/commands)\n#    Skills (wrapped from slash commands):\n#    - Cursor: ~/.cursor/skills/opencontext-*/SKILL.md\n#    - Claude Code: ~/.claude/skills/opencontext-*/SKILL.md (or $CLAUDE_CONFIG_DIR/skills)\n#    - Codex: ~/.codex/skills/opencontext-*/SKILL.md (or $CODEX_HOME/skills)\n#\n# 4. MCP config is user-level (Cursor/Claude Code/Codex)\n#    - Cursor: ~/.cursor/mcp.json\n#    - Claude Code: ~/.claude/mcp.json (or $CLAUDE_CONFIG_DIR/mcp.json)\n#    - Codex: ~/.codex/mcp.json (or $CODEX_HOME/mcp.json)\n```\n\n> 📖 **For detailed usage guide, search configuration, and FAQ, visit the [Website](https://0xranx.github.io/OpenContext/en/usage/).**\n\n---\n\n\n---\n\n## FAQ (Frequently Asked Questions)\n\n### What is OpenContext?\n\nOpenContext is a lightweight **personal context / knowledge store** for AI assistants and coding tools like Cursor / Claude Code / Codex. It gives your AI agent a persistent memory so you can stop repeating yourself and start building smarter.\n\n### How does OpenContext work with my existing coding agent?\n\nOpenContext **reuses your existing coding agent CLI** (Codex/Claude/OpenCode) while adding a GUI plus built-in Skills/tools. You don't pay for a separate agent subscription — you bring your own CLI and get a ready-to-use experience.\n\n### What are the core components?\n\n| Component | Function |\n|-----------|----------|\n| **`oc` CLI** | Manage global `contexts/` library (folders/docs, manifests, search) |\n| **MCP Server** | Cursor/Claude Code/Codex/Agents call OpenContext as tools |\n| **Skills + Slash Commands** | User-level skills for Cursor/Claude Code/Codex + slash commands for Cursor/Claude Code |\n| **Desktop App** | Manage/search/edit contexts with a native UI |\n| **Web UI** | Browse/edit contexts locally (no install required) |\n\n### What coding agents are supported?\n\n| Agent | Config Location |\n|-------|-----------------|\n| Cursor | `~/.cursor/mcp.json` |\n| Claude Code | `~/.claude/mcp.json` |\n| Codex | `~/.codex/mcp.json` |\n| OpenCode | `~/.config/opencode/` |\n\n### What are the key benefits?\n\n| Before OpenContext | After OpenContext |\n|--------------------|-------------------|\n| 📂 Hard to share context across repos/sessions | ✅ Global context library works across all projects |\n| 🤷 Your ideas can't be quickly perceived by Agent | ✅ Agent loads your background & decisions automatically |\n| 🔒 Existing knowledge can't be operated by Coding Agent | ✅ Agent can directly read/write your knowledge base |\n\n### Is OpenContext free and open source?\n\nYes! OpenContext is free and open source. Check the repository for license details.\n\n### How do I get started?\n\n```bash\nnpm install -g @aicontextlab/cli\noc init\n```\n\nThis generates user-level skills and slash commands for your coding agent.\n\n### Where can I get help?\n\n- 📖 [Usage Guide](https://0xranx.github.io/OpenContext/en/usage/)\n- 🌐 [Website](https://0xranx.github.io/OpenContext/en/)\n- 💬 [GitHub Issues](https://github.com/0xranx/OpenContext/issues)\n\n## CLI Commands (Quick Reference)\n\nRun `oc <cmd> --help` for details.\n\n| Command | What it does |\n|---------|--------------|\n| `oc init` | Initialize OpenContext + user-level tool integrations |\n| `oc folder ls` | List folders |\n| `oc folder create <path> -d \"desc\"` | Create a folder |\n| `oc doc create <folder> <name>.md -d \"desc\"` | Create a document |\n| `oc doc ls <folder>` | List documents |\n| `oc context manifest <folder>` | Generate file list for AI to read |\n| `oc search \"query\"` | Search documents |\n| `oc mcp` | Start MCP server for MCP clients |\n| `oc ui` | Start local Web UI |\n\n> 📖 **Full command reference available on the [Website](https://0xranx.github.io/OpenContext/en/usage/).**\n\n---\n\n## Development\n\n```bash\n# Clone & install\ngit clone https://github.com/0xranx/OpenContext.git\ncd OpenContext && npm install\n\n# Desktop app\nnpm run tauri:dev    # development\nnpm run tauri:build  # production build\n\n# Web UI\nnpm run ui:dev       # development\nnpm run ui:build     # production build\n```\n\n---\n\n## License\n\nMIT © [OpenContext](https://github.com/0xranx/OpenContext)\n"}