Reindex GitNexus

VerifiedCaution

Reindex the repository's GitNexus knowledge graph via CLI. Command-line only tool to analyze and update code graph statistics after major changes.

Sby Skills Guide Bot
Data & AIIntermediate
406/2/2026
Claude Code
#gitnexus#knowledge-graph#reindex#code-analysis#cli

Recommended for

Our review

Re-indexes the GitNexus knowledge graph of a repository via the CLI, no MCP server required.

Strengths

  • Fast incremental analysis for daily changes
  • --force option to rebuild the entire index from scratch
  • Detailed before/after stats to validate the update
  • Runs fully locally with no network calls

Limitations

  • Requires the repository to already be initialized with GitNexus
  • Large codebases (>10k files) may take several minutes
  • No MCP server available; CLI-only approach
When to use it

After major refactors, merging a large PR, or when the index is reported as stale.

When not to use it

For minor changes that don't warrant a full reindex, or if GitNexus is not set up in the project.

Security analysis

Caution
Quality score85/100

The skill uses Bash to run npx gitnexus@latest, which fetches and executes code from npm. While the tool is described as local-only, supply chain risk exists. No destructive or exfiltration instructions are present, but caution is warranted due to external code execution.

Findings
  • Runs npx gitnexus@latest which downloads and executes remote code from npm. If the package is compromised, it could exfiltrate data or perform malicious actions.
  • The skill does not verify the integrity of the package beyond npm's default mechanisms.

Examples

Standard reindex
Re-index the GitNexus knowledge graph for this repo using incremental analysis.
Force reindex
Force a full rebuild of the GitNexus index because it appears corrupted.
Check reindex results
Run a status check after reindexing the GitNexus knowledge graph.

name: reindex description: "Re-index the GitNexus knowledge graph via CLI (npx gitnexus@latest). CLI ONLY - NO MCP server exists, never use readMcpResource with gitnexus:// URIs. TRIGGERS - reindex, refresh index, update knowledge graph, gitnexus analyze." allowed-tools: Bash, Read model: haiku

GitNexus Reindex

CLI ONLY — no MCP server exists. Never use readMcpResource with gitnexus:// URIs.

Re-index the current repository's GitNexus knowledge graph and verify the updated stats.

When to Use

  • After significant refactors (5+ files changed)
  • When staleness hook reports index is behind
  • After merging a large PR
  • "Refresh the knowledge graph"

Workflow

Step 1: Check Current Status

Run from the repo root (the CLI auto-detects the repo from cwd):

npx gitnexus@latest status

If already current (lastCommit matches HEAD), report "Index is up to date" and stop.

Step 2: Run Indexer

npx gitnexus@latest analyze

Use --force if the index appears corrupted or if a normal analyze doesn't pick up changes:

npx gitnexus@latest analyze --force

This may take 30–120 seconds depending on codebase size.

Step 3: Verify New Index

npx gitnexus@latest status

Step 4: Report Stats

Present the updated stats:

## GitNexus Reindex Complete

| Metric      | Before | After |
| ----------- | ------ | ----- |
| Nodes       | ...    | ...   |
| Edges       | ...    | ...   |
| Communities | ...    | ...   |
| Flows       | ...    | ...   |
| Last Commit | ...    | ...   |

Index is now current with HEAD.

Notes

  • The analyze command runs locally — no network calls
  • KuzuDB database is stored in .gitnexus/ at the repo root
  • Large codebases (10k+ files) may take 2+ minutes
  • The --force flag rebuilds from scratch; without it, incremental analysis is used
Related skills