关于 gitnexus-cli
GitNexus 命令行参考技能，涵盖仓库索引的构建、状态检查、清理和基于图谱生成文档，面向管理 GitNexus 索引的开发者。
主要功能
- 01构建或更新仓库索引
- 02检查索引是否过期
- 03删除索引和注册信息
- 04生成图谱文档
- 05列出已索引仓库
适用场景
- 01为项目创建索引
- 02检查是否需要重新索引
- 03删除损坏的索引
- 04生成仓库文档
MCP 相关
此命令行工具与 GitNexus MCP 配合使用：其 list 命令可列出已索引仓库，MCP 的 list_repos 工具也提供相同信息。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/gitnexus-cli确认已加载。
详细介绍
GitNexus CLI 命令
所有命令都可通过 npx 运行，无需全局安装。
命令
analyze — 构建或刷新索引
npx gitnexus analyze
请在项目根目录运行。该命令会解析所有源文件、构建知识图谱、将其写入 .gitnexus/，并生成 CLAUDE.md / AGENTS.md 上下文文件。
| 标志 | 效果 |
|---|---|
--force | 即使索引已是最新，也强制完整重新索引 |
--embeddings | 启用语义搜索的嵌入生成（默认关闭） |
运行时机： 首次在项目中使用、代码发生重大变更后，或 gitnexus://repo/{name}/context 报告索引已过期时。在 Claude Code 中，PostToolUse 钩子会在 git commit 和 git merge 后自动运行 analyze；如果之前已生成嵌入，则会保留它们。
status — 检查索引是否为最新
npx gitnexus status
显示当前仓库是否有 GitNexus 索引、索引上次更新时间，以及符号和关系的数量。可用此命令检查是否需要重新索引。
clean — 删除索引
npx gitnexus clean
删除 .gitnexus/ 目录，并将仓库从全局注册表中注销。如果索引已损坏，或从项目中移除 GitNexus 后，可在重新索引前使用此命令。
| 标志 | 效果 |
|---|---|
--force | 跳过确认提示 |
--all | 清理所有已索引的仓库，而不只是当前仓库 |
wiki — 根据图谱生成文档
npx gitnexus 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 — 显示所有已索引的仓库
npx gitnexus list
列出在 ~/.gitnexus/registry.json 中注册的所有仓库。MCP list_repos 工具可提供相同信息。
索引完成后
- 读取
gitnexus://repo/{name}/context，确认索引已加载 - 根据任务使用其他 GitNexus 技能（
exploring、debugging、impact-analysis、refactoring）
故障排除
- “Not inside a git repository”：请在 git 仓库内的目录中运行
- 重新分析后索引仍已过期：重启 Claude Code，以重新加载 MCP 服务
- 嵌入生成缓慢：省略
--embeddings（默认关闭），或设置OPENAI_API_KEY，以使用更快的基于 API 的嵌入生成
评论
支持 Markdown