Vibe Inspector

English | 简体中文

双轨制 AI 代码监察员 -- 让 AI 拥有可溯源的工程记忆

Vibe Inspector 是一个 AI 原生的代码监察系统。它不是另一个 "记录 AI 做了什么" 的工具，而是 让 AI 自己知道项目经历了什么 的系统。

为什么需要 Vibe Inspector

AI 驱动编码面临一个结构性问题：每次新对话，AI 都从零开始。它不记得上次为什么这样写、哪些方案被否决过、哪些文件必须一起改。结果是 AI 反复踩坑、做出与历史决策矛盾的修改。

Vibe Inspector 通过以下方式解决：

• Git 按需计算：时间线、主题切片、文件影响点均在调用 MCP 或 CLI 时从 Git 历史实时算出，无需在仓库中维护预生成的索引 JSON。
• 对话上下文轨：将 AI 会话中的意图、决策、约束保存到 .inspector/sessions/（若团队需要共享，可将这些 JSON 纳入版本控制）。

安装

方式一：一条命令安装（推荐，支持 Claude / Cursor / Codex）

npx vibe-inspector install

安装器会自动：

• 检测本机已安装的 AI 平台（Claude Code、Claude Desktop、Cursor、Codex CLI）
• 为已检测平台写入 vibe-inspector MCP 配置

npx vibe-inspector install --only claude-code,cursor

方式二：Claude Code Plugin

/plugin marketplace add wzc520pyfm/vibe-inspector
/plugin install vibe-inspector@vibe-inspector-plugins

安装后即获得：4 个 Skill、2 个 Slash Command、SessionStart Hook（执行 npx vibe-inspector timeline --ai）、MCP 五个工具。

方式三：MCP Server（Cursor / Claude Desktop / Codex）

Cursor、Claude Desktop、Codex 配置示例见 README.md 英文版「Option 3」小节（与此前相同：npx -y vibe-inspector --mcp）。

方式四：npm 全局安装

npm install -g vibe-inspector

方式五：从源码安装

git clone https://github.com/wzc520pyfm/vibe-inspector.git
cd vibe-inspector
npm install && npm run build
npm link

快速开始

使用 npx vibe-inspector <子命令>；全局安装后可使用 inspector。

只读能力无需事先 init：在 Git 仓库根目录配置好 MCP 即可查询。

cd your-project
npx vibe-inspector status
npx vibe-inspector timeline
npx vibe-inspector timeline --ai
npx vibe-inspector topic auth
npx vibe-inspector impact src/app.ts
npx vibe-inspector capture -s "摘要"

需要团队共享会话记忆时，使用 capture / inspector_capture 后提交 .inspector/sessions/*.json。

AI Skill

| Skill | 触发时机 | 用途 | | ----- | -------- | ---- | | inspector-awareness | 会话开始 | 何时调用 MCP | | inspector-commit | 生成 commit | 高质量 message + trailers | | inspector-query | 需要历史上下文 | 渐进式 MCP 查询 | | inspector-impact | 修改代码前 | 通过 MCP 做影响分析 |

MCP 工具

| 工具 | 用途 | | ---- | ---- | | inspector_timeline | 时间线（Git 实时） | | inspector_topic | 主题/路径（Git + 会话） | | inspector_impact | 影响点（Git 实时） | | inspector_detail | 单条会话或 commit | | inspector_capture | 写入会话 JSON |

数据存储

默认不向仓库写入 commits/、index/ 等预计算目录；仅可选会话文件：

.inspector/
├── .gitignore
└── sessions/

与其他工具的关系

| 维度 | Oobo | g4a | Entire | Vibe Inspector | | ---- | ---- | --- | ------ | ---------------- | | 记录内容 | 统计元数据 | 推理链 | 会话快照 | Git 派生视图 + 可选会话 JSON | | 服务对象 | 人类 | 人类+AI | 人类 | AI 优先 | | 索引能力 | 无 | 关键词搜索 | 检查点列表 | Git 按需计算 + MCP 渐进披露 | | 影响分析 | 无 | 无 | 无 | 历史共变 | | 接入方式 | CLI | CLI | CLI | MCP + AI Plugin |

更多文档

• docs/README.md
• 架构设计（中文，部分为早期设计描述，与当前实现可能不完全一致）：docs/design/vibe-inspector-architecture.md

参与贡献

git clone https://github.com/wzc520pyfm/vibe-inspector.git
cd vibe-inspector
npm install
npm run dev

License

MIT