--- id: sm-opencontext name: "opencontext" url: https://skills.yangsir.net/skill/sm-opencontext author: supercent-io domain: ai-agent-memory-knowledge tags: ["contextual-ai", "retrieval-augmented-generation-(rag)", "llm-context", "knowledge-graphs", "ai-development"] install_count: 10500 rating: 4.50 (420 reviews) github: https://github.com/supercent-io/skills-template --- # opencontext > 该技能为AI助手提供持久化记忆和上下文管理能力，使其无需重复解释，从而构建更智能、更高效的AI系统。 **Stats**: 10,500 installs · 4.5/5 (420 reviews) ## Before / After 对比 ### OpenContext 上下文管理对比 | Metric | Before | After | Change | |---|---|---|---| | - | - | - | - | | - | - | - | - | | - | - | - | - | ## Readme # opencontext # OpenContext Context Management (Persistent Memory) Give your AI assistant persistent memory. Stop repeating explanations, and build smarter. ## When to use this skill - When you need to keep context across sessions - When you need to record project background/decisions - When you need to search prior conclusions/lessons - When you need knowledge sharing in a Multi-Agent workflow - When you want to reduce repetitive background explanations ## 1. Core concepts ### Problem When working with an AI assistant, context gets lost (across sessions, repos, and dates). You end up repeating background, re-explaining decisions, and sometimes the assistant continues with incorrect assumptions. ### Solution **OpenContext** is a lightweight personal context/knowledge store for AI assistants. ``` [Load context] → [Do work] → [Store conclusions] ``` ### Default paths Item Path **Contexts** `~/.opencontext/contexts` **Database** `~/.opencontext/opencontext.db` ## 2. Install and initialize ### Install CLI ``` npm install -g @aicontextlab/cli # Or use npx npx @aicontextlab/cli ``` ### Initialize (run inside the repo) ``` cd your-project oc init ``` **What `oc init` does:** - Prepare the global context store (on first run) - Generate user-level commands/skills + mcp.json for the selected tool - Update the repo's AGENTS.md ## 3. Slash Commands ### Beginner-friendly commands Command Purpose `/opencontext-help` When you don't know where to start `/opencontext-context` **(Recommended default)** Load background before work `/opencontext-search` Search existing documents `/opencontext-create` Create a new document/idea `/opencontext-iterate` Store conclusions and citations ### Install locations ``` # Slash Commands Cursor: ~/.cursor/commands Claude Code: ~/.claude/commands # Skills Cursor: ~/.cursor/skills/opencontext-*/SKILL.md Claude Code: ~/.claude/skills/opencontext-*/SKILL.md Codex: ~/.codex/skills/opencontext-*/SKILL.md # MCP Config Cursor: ~/.cursor/mcp.json Claude Code: ~/.claude/mcp.json ``` ## 4. Core CLI commands ### Folder/document management ``` # List folders oc folder ls --all # Create folder oc folder create project-a -d "My project" # Create document oc doc create project-a design.md -d "Design doc" # List documents oc doc ls project-a ``` ### Search & manifest ``` # Search (keyword/hybrid/vector) oc search "your query" --mode keyword --format json # Generate a manifest (list of files the AI should read) oc context manifest project-a --limit 10 ``` ### Search modes Mode Description Requirements `--mode keyword` Keyword-based search No embeddings required `--mode vector` Vector search Embeddings + index required `--mode hybrid` Hybrid (default) Embeddings + index required ### Embedding configuration (for semantic search) ``` # Set API key oc config set EMBEDDING_API_KEY "<>" # (Optional) Set base URL oc config set EMBEDDING_API_BASE "https://api.openai.com/v1" # (Optional) Set model oc config set EMBEDDING_MODEL "text-embedding-3-small" # Build index oc index build ``` ## 5. MCP Tools ### OpenContext MCP Tools ``` oc_list_folders # List folders oc_list_docs # List documents oc_manifest # Generate manifest oc_search # Search documents oc_create_doc # Create document oc_get_link # Generate stable link ``` ### Multi-Agent integration ``` # Gemini: large-scale analysis ask-gemini "Analyze the structure of the entire codebase" # Codex: run commands shell "docker-compose up -d" # OpenContext: store results oc doc create project-a conclusions.md -d "Analysis conclusions" ``` ## 6. Multi-Agent workflow integration ### Orchestration Pattern ``` [Claude] Plan ↓ [Gemini] Analysis/research + OpenContext search ↓ [Claude] Write code ↓ [Codex] Run/test ↓ [Claude] Synthesize results + store in OpenContext ``` ### Practical example: API design + implementation + testing ``` # 1. [Claude] Design API spec using the skill /opencontext-context # Load project background # 2. [Gemini] Analyze a large codebase ask-gemini "@src/ Analyze existing API patterns" # 3. [Claude] Implement code based on the analysis # (Use context loaded from OpenContext) # 4. [Codex] Test and build shell "npm test && npm run build" # 5. [Claude] Create final report + store conclusions /opencontext-iterate # Store decisions and lessons learned ``` ## 7. Recommended daily workflow ### Before work (1 min) ``` /opencontext-context ``` - Load project background + known pitfalls ### During work ``` /opencontext-search ``` - Search existing conclusions when unsure ### After work (2 min) ``` /opencontext-iterate ``` - Record decisions, pitfalls, and next steps ### High-ROI document types - **Acceptance Criteria** - acceptance criteria - **Common Pitfalls** - common pitfalls - **API Contracts** - API contracts - **Dependency Versions** - dependency versions ## 8. Stable links (Stable Links) Keep links stable across renames/moves by referencing document IDs: ``` [label](oc://doc/) ``` ### Generate a link via CLI ``` oc doc link ``` ### Generate a link via MCP ``` oc_get_link doc_path="Product/api-spec" ``` ## 9. Desktop App & Web UI ### Desktop App (recommended) - Manage/search/edit context with a native UI - Use without the CLI - Automatic index builds (in the background) **Citation features:** Action How Result Cite text snippet Select text → right-click → "Copy Citation" Agent reads the snippet + source Cite document Click the citation icon next to the document title Agent reads the full document + obtains stable_id Cite folder Right-click folder → "Copy Folder Citation" Agent bulk-reads all docs in the folder ### Web UI ``` oc ui # Default URL: http://127.0.0.1:4321 ``` ## Quick Reference ### Essential workflow ``` Before: /opencontext-context (load background) During: /opencontext-search (search) After: /opencontext-iterate (store) ``` ### Core CLI commands ``` oc init # Initialize project oc folder ls --all # List folders oc doc ls # List documents oc search "query" # Search oc doc create ... # Create document ``` ### MCP Tools ``` oc_list_folders list folders oc_list_docs list documents oc_search search oc_manifest manifest oc_create_doc create document oc_get_link generate link ``` ### Paths ``` ~/.opencontext/contexts context store ~/.opencontext/opencontext.db database ``` ## References - [OpenContext Website](https://0xranx.github.io/OpenContext/en/) - [Usage Guide](https://0xranx.github.io/OpenContext/en/usage/) - [Download Desktop](https://github.com/0xranx/OpenContext/releases) - [GitHub Repository](https://github.com/0xranx/OpenContext) Weekly Installs10.3KRepository[supercent-io/sk…template](https://github.com/supercent-io/skills-template)GitHub Stars58First SeenJan 24, 2026Security Audits[Gen Agent Trust HubWarn](/supercent-io/skills-template/opencontext/security/agent-trust-hub)[SocketPass](/supercent-io/skills-template/opencontext/security/socket)[SnykPass](/supercent-io/skills-template/opencontext/security/snyk)Installed oncodex10.3Kgemini-cli10.3Kopencode10.2Kgithub-copilot10.2Kcursor10.2Kamp10.2K --- *Source: https://skills.yangsir.net/skill/sm-opencontext* *Markdown mirror: https://skills.yangsir.net/api/skill/sm-opencontext/markdown*