gitnexus-cli

Runs GitNexus CLI commands to analyze, index, and document code repositories.

3|5|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill gitnexus-cli-bensheridanedwards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-cli
Source: https://github.com/BenSheridanEdwards/ArchitectPlaybook/tree/main/.claude/skills/gitnexus/gitnexus-cli
Command: npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill gitnexus-cli-bensheridanedwards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a GitNexus code index requires knowing the right CLI commands, flags, and recovery steps when the index is missing, stale, or corrupt. This Skill provides the exact command reference for indexing a repo, checking index freshness, cleaning the index, and generating wiki documentation from the knowledge graph. ## Core Features & Use Cases - Index Management: Build or refresh the repository knowledge graph with analyze, check freshness with status, and delete corrupt indexes with clean. - Wiki Generation: Generate LLM-based repository documentation from the knowledge graph, with options for model selection, concurrency, and publishing as a GitHub Gist. - Runner Fallbacks: Uses the project-local node .gitnexus/run.cjs runner that auto-selects a global install, pnpm dlx, or npx, with recovery steps for fresh clones and npm 11.x install crashes. - Use Case: After cloning a repo, run the analyze command to build the knowledge graph and generate CLAUDE.md/AGENTS.md context files, then verify the index loaded before using other GitNexus exploration skills. ## Quick Start Ask the agent to index this repository with GitNexus and then check the index status to confirm it is up to date.

Frequently Asked Questions about gitnexus-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I index a repository with GitNexus?

Run node .gitnexus/run.cjs analyze from the project root. It parses all source files, builds the knowledge graph into .gitnexus/, and generates CLAUDE.md and AGENTS.md context files.

How do I check if my GitNexus index is stale?

Run node .gitnexus/run.cjs status to see when the index was last updated along with symbol and relationship counts. In Claude Code, a PostToolUse hook also detects staleness after git commit or git merge.

What do I do if node .gitnexus/run.cjs reports Cannot find module?

The gitignored runner is missing, typically after a fresh clone or git clean. Regenerate it by running npx gitnexus analyze from the project root, or install globally with npm i -g gitnexus on npm 11.x.

Does GitNexus wiki generation require an API key?

Yes, the wiki command uses an LLM and requires an API key, which is saved to ~/.gitnexus/config.json on first use. You can also pass --api-key, --model, and --base-url flags directly.

How do I delete a corrupt GitNexus index?

Run node .gitnexus/run.cjs clean to delete the .gitnexus/ directory and unregister the repo from the global registry. Use --force to skip the confirmation prompt or --all to clean every indexed repo.