gitnexus-cli

Build and refresh a GitNexus knowledge index for local repositories.

Updated Jul 5, 2025
One-click install
npx skills add https://github.com/nsuberi/ai-prototype-hub --skill gitnexus-cli-nsuberi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus-cli
Source: https://github.com/nsuberi/ai-prototype-hub/tree/main/.claude/skills/gitnexus/gitnexus-cli
Command: npx skills add https://github.com/nsuberi/ai-prototype-hub --skill gitnexus-cli-nsuberi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitNexus CLI helps you build and maintain a searchable knowledge index of a codebase so you can quickly inspect structure, freshness, and derived documentation.

Core Features & Use Cases

  • analyze (index build/refresh): Parse source files, build a knowledge graph, write it to .gitnexus/, and generate CLAUDE.md and AGENTS.md context artifacts.
  • status (index freshness checks): Verify whether an index exists, when it was last updated, and key counts so you know if re-indexing is needed.
  • wiki (graph-to-documentation generation): Generate repository documentation from the knowledge graph using an LLM, optionally using flags like model selection, concurrency, and gist publishing.
  • clean and list (index management): Remove corrupted indexes or unregister repos, and list all indexed repositories from the registry.

Quick Start

Run npx gitnexus analyze from the project root to build or refresh the GitNexus index for this repository.

Frequently Asked Questions about gitnexus-cli

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

FAQPage Schema
How do I build a knowledge graph from my local codebase for semantic search?

To build a knowledge graph from your local codebase, run `npx gitnexus analyze` from your git project root to parse source files and write a searchable index to the `.gitnexus/` directory.

How can I generate documentation and context files for my repository?

You can generate repository documentation and context files by running the `analyze` command to create `CLAUDE.md` and `AGENTS.md`, or use the `wiki` command to produce LLM-generated documentation from the knowledge graph.

How do I check if my codebase index is outdated or needs reanalysis?

Check your codebase index freshness by running `npx gitnexus status`, which verifies if an index exists, displays the last update time, and reports key counts so you know if reanalysis is needed.

Can I prepare embeddings for codebase analysis in a git repository?

Yes, you can prepare embeddings for codebase analysis by running `npx gitnexus analyze --embeddings` from your git project root to enable semantic search preparation within the generated knowledge graph.

What is the best way to manage corrupted repository indexes during codebase analysis?

The best way to manage corrupted repository indexes is to run `npx gitnexus clean` to remove corrupted indexes, or use `npx gitnexus list` to view all indexed repositories from the registry.

How do I force a full reindex of my repository knowledge graph?

Force a full reindex of your repository knowledge graph by running `npx gitnexus analyze --force` from the project root, which overwrites the existing `.gitnexus/` index with freshly parsed source files.