关于 gitnexus-cli
用于在仓库中操作 GitNexus 索引的命令行技能，可分析源代码、检查索引状态、清理索引、生成图谱文档并列出已索引仓库。适合准备或维护 GitNexus 代码探索所需数据的开发者。
主要功能
- 01构建或刷新代码索引
- 02检查索引是否最新
- 03删除仓库索引
- 04根据图谱生成文档
- 05列出已索引仓库
适用场景
- 01代码探索前为仓库建立索引
- 02重大变更后刷新索引
- 03检查索引是否过期
- 04根据仓库图谱生成文档
MCP 相关
该技能使用 GitNexus MCP 资源和工具，包括 `list_repos` 与 `gitnexus://repo/{name}/context`，用于查看已索引仓库及其上下文。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/gitnexus-cli确认已加载。
详细介绍
GitNexus CLI 命令
以下命令使用 node .gitnexus/run.cjs <command> — 项目本地运行器 gitnexus analyze 会放置在索引旁边。调用时会自动选择可用的运行器（优先使用全局 gitnexus，其次是 pnpm dlx，最后是 npx），因此不依赖特定包管理器，也无需全局安装。
尚未分析，或者
node .gitnexus/run.cjs报告Cannot find module（被 Git 忽略的运行器不存在——例如刚克隆项目或运行了git clean）？可在项目根目录运行npx gitnexus analyze重新生成。在 npm 11.x 中，如果npx在安装时崩溃（node.target is null），请使用npm i -g gitnexus安装一次（然后运行gitnexus analyze），或使用pnpm --allow-build=@ladybugdb/core --allow-build=gitnexus --allow-build=tree-sitter dlx gitnexus@latest analyze。参见 #1939。
命令
analyze — 构建或刷新索引
node .gitnexus/run.cjs analyze
在项目根目录运行。此命令会解析所有源文件、构建知识图谱、将其写入 .gitnexus/，并生成 CLAUDE.md / AGENTS.md 上下文文件。
| 标志 | 效果 |
|---|---|
--force | 即使索引已是最新，也强制完整重新索引 |
--embeddings | 启用嵌入生成以支持语义搜索（默认关闭） |
--drop-embeddings | 重建时删除现有嵌入。默认情况下，不带 --embeddings 的 analyze 会保留嵌入。 |
--pdg | 构建 explain 和 pdg_query 使用的程序依赖层（taint、CDG 和 REACHING_DEF）。 |
何时运行： 首次在项目中使用时、进行重大代码更改后，或 gitnexus://repo/{name}/context 报告索引已过期时。在 Claude Code 中，PostToolUse 钩子会在 git commit 和 git merge 后检测索引是否过期，并通知 Agent 运行 analyze — 钩子本身不会运行 analyze，以避免阻塞 Agent 最长达 120s，并防止超时导致 KuzuDB 损坏。
status — 检查索引是否最新
node .gitnexus/run.cjs status
显示当前仓库是否有 GitNexus 索引、索引的上次更新时间，以及符号和关系数量。可用此命令检查是否需要重新索引。
clean — 删除索引
node .gitnexus/run.cjs clean
删除 .gitnexus/ 目录，并从全局注册表中取消注册该仓库。如果索引已损坏，或从项目中移除 GitNexus 后，可在重新索引前使用此命令。
| 标志 | 效果 |
|---|---|
--force | 跳过确认提示 |
--all | 清理所有已索引的仓库，而不仅是当前仓库 |
wiki — 根据图谱生成文档
node .gitnexus/run.cjs wiki
使用大模型根据知识图谱生成仓库文档。需要 API 密钥（首次使用时保存到 ~/.gitnexus/config.json）。
| 标志 | 效果 |
|---|---|
--force | 强制完整重新生成 |
--model <model> | 大模型（默认：minimax/minimax-m2.5） |
--base-url <url> | 大模型 API 基础 URL |
--api-key <key> | 大模型 API 密钥 |
--concurrency <n> | 并行大模型调用数（默认：3） |
--gist | 将 wiki 发布为公开的 GitHub Gist |
list — 显示所有已索引的仓库
node .gitnexus/run.cjs list
列出注册在 ~/.gitnexus/registry.json 中的所有仓库。MCP list_repos 工具会提供相同信息。
索引完成后
- 读取
gitnexus://repo/{name}/context，验证索引已加载 - 根据任务使用其他 GitNexus 技能（
exploring、debugging、impact-analysis、refactoring）
故障排除
- “不在 git 仓库内”：请在 git 仓库内的目录中运行
- 重新分析后索引仍然过时：重启 Claude Code 以重新加载 MCP 服务
- 嵌入速度较慢：省略
--embeddings（默认关闭），或设置OPENAI_API_KEY，以便更快地通过 API 进行嵌入