GitNexus CLI 提供一组通过 npx 执行的命令，用于对代码仓库建立索引并生成知识图谱，无需全局安装。
【用途】 主要用于分析/索引仓库、检查索引状态、清理索引、生成 wiki 文档，以及列出已索引的仓库。索引结果可供后续的 GitNexus 技能（如探索、调试、影响分析、重构）使用。
【主要能力】
- analyze：构建或刷新索引。从项目根目录运行，解析所有源文件、构建知识图谱、写入 .gitnexus/ 目录，并生成 CLAUDE.md / AGENTS.md 上下文文件。支持 --force（即使已是最新也强制全量重建索引）和 --embeddings（启用嵌入生成以支持语义搜索，默认关闭）。
- status：检查索引新鲜度。显示当前仓库是否有 GitNexus 索引、最后更新时间以及符号/关系数量，用于判断是否需要重新索引。
- clean：删除索引。删除 .gitnexus/ 目录并从全局注册表注销该仓库。支持 --force（跳过确认提示）和 --all（清理所有已索引仓库，而不仅是当前仓库）。
- wiki：从图谱生成文档。使用 LLM 基于知识图谱生成仓库文档，需要 API key（首次使用时保存到 ~/.gitnexus/config.json）。支持 --force（强制全量重新生成）、--model <model>（LLM 模型，默认 minimax/minimax-m2.5）、--base-url <url>（LLM API base URL）、--api-key <key>（LLM API key）、--concurrency <n>（并行 LLM 调用数，默认 3）、--gist（将 wiki 发布为公开 GitHub Gist）。
- list：显示所有已索引仓库。列出注册在 ~/.gitnexus/registry.json 中的所有仓库；MCP 的 list_repos 工具提供相同信息。
【使用方式】 所有命令通过 npx 执行。示例：
- npx gitnexus analyze
- npx gitnexus status
- npx gitnexus clean
- npx gitnexus wiki
- npx gitnexus list
analyze 需在项目根目录运行。在 Claude Code 中，PostToolUse 钩子会在 git commit 和 git merge 后自动运行 analyze，并在之前已生成嵌入的情况下保留嵌入。索引完成后，可读取 gitnexus://repo/{name}/context 验证索引是否加载，并使用其他 GitNexus 技能处理任务。
【适用场景】
- 首次在项目中建立索引，或重大代码变更后刷新索引。
- 当 gitnexus://repo/{name}/context 报告索引过期时重新索引。
- 检查索引状态、清理损坏或不再需要的索引。
- 基于知识图谱生成仓库文档。
【限制与注意事项】
- 需在 git 仓库内的目录中运行，否则报错 "Not inside a git repository"。
- 重新 analyze 后索引若显示过期，需重启 Claude Code 以重新加载 MCP 服务器。
- 嵌入生成可能较慢：可省略 --embeddings（默认关闭），或设置 OPENAI_API_KEY 以使用更快的基于 API 的嵌入。
- wiki 功能依赖 LLM 与 API key，默认模型为 minimax/minimax-m2.5。
- 具体的收费、价格与定价信息暂未提供。