Arcmind gitnexus-cli
Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: \"Index this repo\", \"Reanalyze the codebase\", \"Generate a wiki\"
install
source · Clone the upstream repo
git clone https://github.com/eason-tien/arcmind
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/eason-tien/arcmind "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/gitnexus/gitnexus-cli" ~/.claude/skills/eason-tien-arcmind-gitnexus-cli && rm -rf "$T"
manifest:
.claude/skills/gitnexus/gitnexus-cli/SKILL.mdsource content
GitNexus CLI Commands
All commands work via
npx — no global install required.
Commands
analyze — Build or refresh the index
npx gitnexus analyze
Run from the project root. This parses all source files, builds the knowledge graph, writes it to
.gitnexus/, and generates CLAUDE.md / AGENTS.md context files.
| Flag | Effect |
|---|---|
| Force full re-index even if up to date |
| Enable embedding generation for semantic search (off by default) |
When to run: First time in a project, after major code changes, or when
gitnexus://repo/{name}/context reports the index is stale.
status — Check index freshness
npx gitnexus status
Shows whether the current repo has a GitNexus index, when it was last updated, and symbol/relationship counts. Use this to check if re-indexing is needed.
clean — Delete the index
npx gitnexus clean
Deletes the
.gitnexus/ directory and unregisters the repo from the global registry. Use before re-indexing if the index is corrupt or after removing GitNexus from a project.
| Flag | Effect |
|---|---|
| Skip confirmation prompt |
| Clean all indexed repos, not just the current one |
wiki — Generate documentation from the graph
npx gitnexus wiki
Generates repository documentation from the knowledge graph using an LLM. Requires an API key (saved to
~/.gitnexus/config.json on first use).
| Flag | Effect |
|---|---|
| Force full regeneration |
| LLM model (default: minimax/minimax-m2.5) |
| LLM API base URL |
| LLM API key |
| Parallel LLM calls (default: 3) |
| Publish wiki as a public GitHub Gist |
list — Show all indexed repos
npx gitnexus list
Lists all repositories registered in
~/.gitnexus/registry.json. The MCP list_repos tool provides the same information.
After Indexing
- Read
to verify the index loadedgitnexus://repo/{name}/context - Use the other GitNexus skills (
,exploring
,debugging
,impact-analysis
) for your taskrefactoring
Troubleshooting
- "Not inside a git repository": Run from a directory inside a git repo
- Index is stale after re-analyzing: Restart Claude Code to reload the MCP server
- Embeddings slow: Omit
(it's off by default) or set--embeddings
for faster API-based embeddingOPENAI_API_KEY