用途：GitNexus CLI 用于对代码仓库执行索引与知识图谱相关操作，全部命令通过 npx 运行，无需全局安装。
主要能力：analyze 从项目根目录运行，解析源文件、构建知识图谱、写入 .gitnexus/，并生成 CLAUDE.md / AGENTS.md 上下文文件；可选 --force 强制全量重建，--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 发布为公开 GitHub Gist。list 列出 ~/.gitnexus/registry.json 中注册的所有仓库。
建议时机：首次在项目中使用、代码大幅变更后，或 gitnexus://repo/{name}/context 报告索引过期时运行 analyze。在 Claude Code 中，PostToolUse 钩子会在 git commit 与 git merge 后自动运行 analyze，并保留此前生成的向量。索引后可读取 gitnexus://repo/{name}/context 验证加载情况。
限制与提示：必须在 git 仓库内运行，否则提示“Not inside a git repository”；重新分析后索引仍显示过期，可重启 Claude Code 以重载 MCP 服务器；向量生成较慢时可省略 --embeddings（默认关闭）或设置 OPENAI_API_KEY 使用 API 向量。