{"id":43779297,"url":"https://github.com/0xranx/OpenContext","last_synced_at":"2026-02-17T07:00:59.440Z","repository":{"id":329098216,"uuid":"1118099356","full_name":"0xranx/OpenContext","owner":"0xranx","description":"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.","archived":false,"fork":false,"pushed_at":"2026-01-25T15:40:01.000Z","size":46986,"stargazers_count":352,"open_issues_count":2,"forks_count":20,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-26T08:43:44.818Z","etag":null,"topics":["agent","ai","ai-agents","claude-code","cli","codex","context","context-management","cursor","desktop-app","developer-tools","knowledge-base","mcp","opencode","tauri"],"latest_commit_sha":null,"homepage":"https://0xranx.github.io/OpenContext/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xranx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-17T09:05:19.000Z","updated_at":"2026-01-25T21:14:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/0xranx/OpenContext","commit_stats":null,"previous_names":["gloria-zxr/opencontext"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/0xranx/OpenContext","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xranx%2FOpenContext","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xranx%2FOpenContext/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xranx%2FOpenContext/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xranx%2FOpenContext/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xranx","download_url":"https://codeload.github.com/0xranx/OpenContext/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xranx%2FOpenContext/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29536527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T05:00:25.817Z","status":"ssl_error","status_checked_at":"2026-02-17T04:57:16.126Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","ai-agents","claude-code","cli","codex","context","context-management","cursor","desktop-app","developer-tools","knowledge-base","mcp","opencode","tauri"],"created_at":"2026-02-05T18:00:37.321Z","updated_at":"2026-02-17T07:00:59.351Z","avatar_url":"https://github.com/0xranx.png","language":"JavaScript","funding_links":[],"categories":["\u003ca name=\"JavaScript\"\u003e\u003c/a\u003eJavaScript","MCP Servers","JavaScript"],"sub_categories":["Knowledge \u0026 Memory"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/images/logo-dark.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"docs/images/logo-light.png\"\u003e\n    \u003cimg alt=\"OpenContext Logo\" src=\"docs/images/logo-light.png\" width=\"350\"\u003e\n  \u003c/picture\u003e\n\n  \u003cp\u003e\n    \u003cstrong\u003eGive your AI assistant a persistent memory.\u003c/strong\u003e\u003cbr\u003e\n    Stop repeating yourself. Start building smarter.\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003cstrong\u003eBring your own coding agent.\u003c/strong\u003e OpenContext reuses your existing CLI (Codex/Claude/OpenCode) and adds a GUI + built-in Skills/tools — no extra agent subscription.\n  \u003c/p\u003e\n\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\n        \u003cimg src=\"docs/images/overview.png\" alt=\"OpenContext Overview\" height=\"260\"\u003e\n      \u003c/td\u003e\n      \u003ctd\u003e\n        \u003cimg src=\"docs/images/folder-refer-git.gif\" alt=\"OpenContext Demo\" height=\"260\"\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://www.npmjs.com/package/@aicontextlab/cli\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@aicontextlab/cli.svg?style=flat-square\u0026color=cb3837\" alt=\"npm version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/0xranx/OpenContext/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/0xranx/OpenContext?style=flat-square\" alt=\"license\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://0xranx.github.io/OpenContext/en/\"\u003e\u003cstrong\u003e🌐 Website\u003c/strong\u003e\u003c/a\u003e · \n    \u003ca href=\"https://0xranx.github.io/OpenContext/en/usage/\"\u003e\u003cstrong\u003e📖 Usage Guide\u003c/strong\u003e\u003c/a\u003e · \n    \u003ca href=\"https://github.com/0xranx/OpenContext/releases\"\u003e\u003cstrong\u003e⬇️ Download Desktop\u003c/strong\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\u003ca href=\"README.zh-CN.md\"\u003e中文文档\u003c/a\u003e\u003c/p\u003e\n\u003c/div\u003e\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 \u0026 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 \u0026\u0026 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\u003e 📖 **For detailed usage guide, search configuration, and FAQ, visit the [Website](https://0xranx.github.io/OpenContext/en/usage/).**\n\n---\n\n## CLI Commands (Quick Reference)\n\nRun `oc \u003ccmd\u003e --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 \u003cpath\u003e -d \"desc\"` | Create a folder |\n| `oc doc create \u003cfolder\u003e \u003cname\u003e.md -d \"desc\"` | Create a document |\n| `oc doc ls \u003cfolder\u003e` | List documents |\n| `oc context manifest \u003cfolder\u003e` | 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\u003e 📖 **Full command reference available on the [Website](https://0xranx.github.io/OpenContext/en/usage/).**\n\n---\n\n## Development\n\n```bash\n# Clone \u0026 install\ngit clone https://github.com/0xranx/OpenContext.git\ncd OpenContext \u0026\u0026 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xranx%2FOpenContext","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xranx%2FOpenContext","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xranx%2FOpenContext/lists"}