OpenContext

官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

痛点

当你用 AI 助手做事时，上下文会丢、历史决策会忘、跨天/跨仓库会断片。你很容易重复解释背景、重复踩坑，甚至让 AI 在错误前提下继续执行。很多工具只停留在“管理”，并没有接入你已经在用的 coding agent。

解决方案

OpenContext 是一个面向 AI 助手（Agent）与 Cursor / Claude Code / Codex 等编码工具用户的「个人上下文/知识库」。它直接复用你已有的 coding agent CLI（Codex/Claude/OpenCode），并提供 GUI 与内置 Skills/工具，让 AI 助手能「先读历史再动手、做完再沉淀」。

Skills 优先支持： oc init 会生成用户级 skills（Cursor/Claude Code/Codex）和斜杠命令（Cursor/Claude Code），让 Agent 用一条命令完成加载、搜索、创建与迭代。

包含什么

• oc CLI — 管理全局 contexts/ 文档库（目录/文档、清单、检索）
• MCP Server — 让 Cursor/Claude Code/Codex/Agent 通过工具调用 OpenContext
• Skills + 斜杠命令 — 为 Cursor/Claude Code/Codex 生成用户级 skills，为 Cursor/Claude Code 生成斜杠命令（由 oc init 生成）
• 面向 Agent 的知识层 — 复用你已有的 coding agent CLI（Codex/Claude/OpenCode），并内置 Skills/工具 + GUI
• 桌面版应用 — 用原生 UI 管理/搜索/编辑 contexts
• Web UI — 本地浏览/编辑文档（无需安装桌面版）

为什么 OpenContext 更适合开发者

OpenContext 的知识管理 Agent 可以直接用你已经在用的 coding agent CLI（Codex/Claude/OpenCode），不需要为另一套 Agent 再付费。你带来自己熟悉的代理工具，OpenContext 直接提供现成 GUI 和内置 Skills/工具，让 Agent 能读、搜、写、迭代你的知识库。

快速开始

安装 CLI

npm install -g @aicontextlab/cli

选择你的路径

OpenContext 不替换你的 Agent，而是复用你已有的 coding agent CLI，并补上 GUI 与内置 Skills/工具。

30 秒上手（CLI + Cursor/Claude Code/Codex）

# 1. 安装
npm install -g @aicontextlab/cli

# 2. 初始化（会提示选择工具，默认全选）
cd your-project
oc init

# 3. 在 Cursor / Claude Code 中使用斜杠命令
#    /opencontext-context  — 开始工作前加载背景
#    /opencontext-search   — 查找相关文档
#    /opencontext-create   — 创建新文档
#    /opencontext-iterate  — 沉淀学到的内容
#    提示：非交互可用 --tools cursor,claude,codex 或 --no-claude/--no-cursor/--no-codex
#
#    oc init 会安装：
#    - Cursor: ~/.cursor/commands
#    - Claude Code: ~/.claude/commands（或 $CLAUDE_CONFIG_DIR/commands）
#    Skills（斜杠命令的同名封装）：
#    - Cursor: ~/.cursor/skills/opencontext-*/SKILL.md
#    - Claude Code: ~/.claude/skills/opencontext-*/SKILL.md（或 $CLAUDE_CONFIG_DIR/skills）
#    - Codex: ~/.codex/skills/opencontext-*/SKILL.md（或 $CODEX_HOME/skills）
#
#    用户级 MCP 配置：
#    - Cursor: ~/.cursor/mcp.json
#    - Claude Code: ~/.claude/mcp.json（或 $CLAUDE_CONFIG_DIR/mcp.json）
#    - Codex: ~/.codex/mcp.json（或 $CODEX_HOME/mcp.json）

📖 详细使用指南、搜索配置和常见问题，请访问官网。

CLI 命令（快速参考）

运行 oc <cmd> --help 查看详情。

📖 完整命令参考请访问官网。

开发

# 克隆并安装
git clone https://github.com/0xranx/OpenContext.git
cd OpenContext && npm install

# 桌面版应用
npm run tauri:dev    # 开发模式
npm run tauri:build  # 生产构建

# Web UI
npm run ui:dev       # 开发模式
npm run ui:build     # 生产构建

许可证

MIT © OpenContext