https://github.com/0xranx/OpenContext
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.
https://github.com/0xranx/OpenContext
agent ai ai-agents claude-code cli codex context context-management cursor desktop-app developer-tools knowledge-base mcp opencode tauri
Last synced: about 7 hours ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/0xranx/OpenContext
- Owner: 0xranx
- License: mit
- Created: 2025-12-17T09:05:19.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-01-25T15:40:01.000Z (23 days ago)
- Last Synced: 2026-01-26T08:43:44.818Z (22 days ago)
- Topics: agent, ai, ai-agents, claude-code, cli, codex, context, context-management, cursor, desktop-app, developer-tools, knowledge-base, mcp, opencode, tauri
- Language: JavaScript
- Homepage: https://0xranx.github.io/OpenContext/
- Size: 44.8 MB
- Stars: 352
- Watchers: 4
- Forks: 20
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-mcp - 0xranx/OpenContext - OpenContext is a personal context and knowledge store that integrates with existing AI coding agents to provide persistent memory, enabling smarter, context-aware interactions and seamless reuse of project knowledge across sessions and repositories. (MCP Servers / Knowledge & Memory)
README
Give your AI assistant a persistent memory.
Stop repeating yourself. Start building smarter.
Bring your own coding agent. OpenContext reuses your existing CLI (Codex/Claude/OpenCode) and adds a GUI + built-in Skills/tools — no extra agent subscription.
🌐 Website ·
📖 Usage Guide ·
⬇️ Download Desktop
---
## The Problem
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.
## The Solution
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 |
## What's Included
- **`oc` CLI** — manage a global `contexts/` library (folders/docs, manifests, search)
- **MCP Server** — so Cursor/Claude Code/Codex/Agents can call OpenContext as tools
- **Skills + Slash Commands** — user-level skills for Cursor/Claude Code/Codex and slash commands for Cursor/Claude Code (generated by `oc init`)
- **Agent-ready Knowledge Layer** — reuse your existing coding agent CLI (Codex/Claude/OpenCode) with built-in skills/tools and GUI
- **Desktop App** — manage/search/edit contexts with a native UI
- **Web UI** — browse/edit contexts locally (no install required)
## Why OpenContext for Builders
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.
## Quick Start
### Install CLI
```bash
npm install -g @aicontextlab/cli
```
### Choose Your Path
| Path | Best For | Get Started |
|------|----------|-------------|
| 🖥️ **Desktop App** | Visual users who want a native UI | [Download from Releases](https://github.com/0xranx/OpenContext/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.
### 30-Second Setup (CLI + Cursor/Claude Code/Codex)
```bash
# 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](https://0xranx.github.io/OpenContext/en/usage/).**
---
## CLI Commands (Quick Reference)
Run `oc --help` for details.
| Command | What it does |
|---------|--------------|
| `oc init` | Initialize OpenContext + user-level tool integrations |
| `oc folder ls` | List folders |
| `oc folder create -d "desc"` | Create a folder |
| `oc doc create .md -d "desc"` | Create a document |
| `oc doc ls ` | List documents |
| `oc context manifest ` | 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](https://0xranx.github.io/OpenContext/en/usage/).**
---
## Development
```bash
# 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
```
---
## License
MIT © [OpenContext](https://github.com/0xranx/OpenContext)