# Analyze

> GitNexus Analyze

- Skill: `roxabi/analyze-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add roxabi/analyze-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/roxabi/analyze-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Roxabi (https://skillmd.com/u/roxabi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/roxabi/analyze-2

---


# GitNexus Analyze

Index a repository into a knowledge graph — parses source files, builds call/dependency relationships, detects execution flows.

## Entry

```
/gitnexus-analyze [path]
/gitnexus-analyze --force        # Force full re-index
/gitnexus-analyze --embeddings   # Enable semantic search vectors
```

## Step 0 — Check Installation

```bash
which gitnexus || npm list -g gitnexus
```

¬found → ask user install first: `npm install -g gitnexus`.

## Step 1 — Resolve Path

No path arg → use current working directory.

Path arg → resolve to absolute path.

¬git repo at path → ask user path must be inside a git repository, or use `--skip-git` flag.

## Step 2 — Run Analysis

```bash
cd "$REPO_PATH" && gitnexus analyze $FLAGS
```

| Flag | Effect |
|------|--------|
| `--force` | Full re-index even if up to date |
| `--embeddings` | Enable vector embeddings (slower, better semantic search) |
| `--skip-git` | Index folder without `.git` directory |
| `--verbose` | Show skipped files and warnings |

## Step 3 — Parse Output

Read JSON output → extract:

| Field | Meaning |
|-------|---------|
| `stats.symbols` | Number of indexed symbols |
| `stats.relationships` | Number of relationships |
| `stats.processes` | Number of execution flows |
| `path` | Where `.gitnexus/` was created |

## Step 4 — Report

**Done:**
- Indexed `{N}` symbols, `{M}` relationships, `{P}` processes
- Graph stored at `.gitnexus/`
- Run `/gitnexus-query` to search, `/gitnexus-impact` before edits

## Error Handling

- "Not inside a git repository" → suggest `--skip-git` or change directory
- "No supported languages found" → list supported: TypeScript, JavaScript, Python, Go, Rust, Java, C++, Ruby, etc.
- "Out of memory" → large repo, suggest `--skip-git` or increase Node heap

$ARGUMENTS