dhpk-gitnexus-clilisted
Install: claude install-skill hmj1026/dhpk
# GitNexus CLI Commands
The schema, tool names, and MCP resource catalog are owned by
`dhpk-gitnexus-guide`; this skill owns only CLI lifecycle commands and their
verification.
All commands work via `npx` — no global install required.
## Commands
### analyze — Build or refresh the index
```bash
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` | Force full re-index even if up to date |
| `--embeddings` | Enable embedding generation for semantic search (off by default) |
| `--drop-embeddings` | Drop existing embeddings on rebuild. By default, an `analyze` without `--embeddings` preserves them. |
**When to run:** First time in a project or after major code changes. If the
guide or context resource reports a stale index, follow the recovery contract
owned by `dhpk-gitnexus-guide` instead of improvising a refresh.
### status — Check index freshness
```bash
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
```bash
npx gitnexus clean
```
Deletes the `.gitnexus/` dire