CLI + MCP server for managing shared LLM context stores
$git clone https://github.com/0xranx/opencontextInstalls into the current project.
Install opencontext by running `git clone https://github.com/0xranx/opencontext`, then use it for the current task and follow its documentation at https://github.com/0xranx/opencontext.
| 1 | <div align="center"> |
| 2 | <picture> |
| 3 | <source media="(prefers-color-scheme: dark)" srcset="docs/images/logo-dark.png"> |
| 4 | <source media="(prefers-color-scheme: light)" srcset="docs/images/logo-light.png"> |
| 5 | <img alt="OpenContext Logo" src="docs/images/logo-light.png" width="350"> |
| 6 | </picture> |
| 7 | |
| 8 | <p> |
| 9 | <strong>Give your AI assistant a persistent memory.</strong><br> |
| 10 | Stop repeating yourself. Start building smarter. |
| 11 | </p> |
| 12 | |
| 13 | <p> |
| 14 | <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. |
| 15 | </p> |
| 16 | |
| 17 | <table> |
| 18 | <tr> |
| 19 | <td> |
| 20 | <img src="docs/images/overview.png" alt="OpenContext Overview" height="260"> |
| 21 | </td> |
| 22 | <td> |
| 23 | <img src="docs/images/folder-refer-git.gif" alt="OpenContext Demo" height="260"> |
| 24 | </td> |
| 25 | </tr> |
| 26 | </table> |
| 27 | |
| 28 | <p> |
| 29 | <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> |
| 30 | <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> |
| 31 | </p> |
| 32 | |
| 33 | <p> |
| 34 | <a href="https://0xranx.github.io/OpenContext/en/"><strong>🌐 Website</strong></a> · |
| 35 | <a href="https://0xranx.github.io/OpenContext/en/usage/"><strong>📖 Usage Guide</strong></a> · |
| 36 | <a href="https://github.com/0xranx/OpenContext/releases"><strong>⬇️ Download Desktop</strong></a> |
| 37 | </p> |
| 38 | |
| 39 | <p><a href="README.zh-CN.md">中文文档</a></p> |
| 40 | </div> |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## The Problem |
| 45 | |
| 46 | When 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. |
| 47 | |
| 48 | ## The Solution |
| 49 | |
| 50 | 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". |
| 51 | |
| 52 | **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. |
| 53 | |
| 54 | | Before OpenContext | After OpenContext | |
| 55 | |-------------------|-------------------| |
| 56 | | 📂 Hard to share context across repos/sessions | ✅ Global context library works across all projects | |
| 57 | | 🤷 Your ideas can't be quickly perceived by Agent | ✅ Agent loads your background & decisions automatically | |
| 58 | | 🔒 Existing knowledge can't be operated by Coding Agent | ✅ Agent can directly read/write your knowledge base | |
| 59 | |
| 60 | ## What's Included |
| 61 | |
| 62 | - **`oc` CLI** — manage a global `contexts/` library (folders/docs, manifests, search) |
| 63 | - **MCP Server** — so Cursor/Claude Code/Codex/Agents can call OpenContext as tools |
| 64 | - **Skills + Slash Commands** — user-level skills for Cursor/Claude Code/Codex and slash commands for Cursor/Claude Code (generated by `oc init`) |
| 65 | - **Agent-ready Knowledge Layer** — reuse your existing coding agent CLI (Codex/Claude/OpenCode) with built-in skills/tools and GUI |
| 66 | - **Desktop App** — manage/search/edit contexts with a native UI |
| 67 | - **Web UI** — browse/edit contexts locally (no install required) |
| 68 | |
| 69 | ## Why OpenContext for Builders |
| 70 | |
| 71 | 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. |
| 72 | |
| 73 | ## Quick Start |
| 74 | |
| 75 | ### Install CLI |
| 76 | |
| 77 | ```bash |
| 78 | npm install -g @aicontextlab/cli |
| 79 | ``` |
| 80 | |
| 81 | ### Choose Your Path |
| 82 | |
| 83 | | Path | Best |