用途:GitNexus CLI 用于对代码仓库建立知识图谱索引,并围绕索引提供状态检查、清理、文档生成和仓库列表等操作。所有命令通过 npx 运行,无需全局安装。
主要能力:analyze 在项目根目录运行,解析源文件、构建知识图谱、写入 .gitnexus/ 并生成 CLAUDE.md / AGENTS.md 上下文文件;支持 --force 强制全量重建、--embeddings 启用语义搜索嵌入(默认关闭)、--drop-embeddings 在重建时丢弃已有嵌入。status 显示当前仓库是否有索引、最后更新时间及符号与关系数量。clean 删除 .gitnexus/ 并从全局注册表注销仓库,支持 --force 跳过确认、--all 清理全部已索引仓库。wiki 借助 LLM 从知识图谱生成仓库文档,需要 API 密钥(首次使用保存到 ~/.gitnexus/config.json),支持 --force、--model(默认 minimax/minimax-m2.5)、--base-url、--api-key、--concurrency(默认 3)、--gist。list 列出 ~/.gitnexus/registry.json 中注册的所有仓库。
使用方式:在 git 仓库内运行 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 嵌入。其余细节暂未提供。