用途:GitNexus CLI 通过 npx 调用,无需全局安装,用于为 Git 仓库建立并管理知识图谱索引,并生成可供 AI 使用的上下文文件。
主要命令:analyze 构建或刷新索引,需在项目根目录运行,会解析源文件、构建知识图谱、写入 .gitnexus/ 并生成 CLAUDE.md / AGENTS.md;status 查看当前仓库是否有索引、最后更新时间及符号与关系数量;clean 删除 .gitnexus/ 并从全局注册表注销仓库;wiki 借助 LLM 依据知识图谱生成仓库文档,首次使用需 API 密钥(保存至 ~/.gitnexus/config.json);list 列出 ~/.gitnexus/registry.json 中登记的所有仓库。
常用参数:analyze 支持 --force 强制全量重建、--embeddings 启用语义搜索的向量生成(默认关闭);clean 支持 --force 跳过确认、--all 清理所有已索引仓库;wiki 支持 --force、--model、--base-url、--api-key、--concurrency、--gist。
使用方式:在项目根目录执行 npx gitnexus analyze;索引后读取 gitnexus://repo/{name}/context 验证加载,并可配合其它 GitNexus 技能完成探索、调试、影响分析与重构。在 Claude Code 中,PostToolUse 钩子会在 git commit 与 git merge 后自动运行 analyze,并保留此前生成的嵌入。
限制与排错:不在 Git 仓库内运行会报错;重新分析后索引显示过期需重启 Claude Code 以重载 MCP 服务;嵌入较慢时可省略 --embeddings 或设置 OPENAI_API_KEY 使用 API。嵌入与 wiki 涉及的外部服务费用与具体定价暂未提供。