# Status

> GitNexus Status

- Skill: `roxabi/status` (Agent Skill)
- Install (CLI): `npx skillmds@latest add roxabi/status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/roxabi/status/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/status

---


# GitNexus Status

Check if the current repository is indexed and whether the index is stale (behind HEAD).

## Entry

```
/gitnexus-status
```

## Step 1 — Run Status

```bash
gitnexus status
```

## Step 2 — Parse JSON Output

```json
{
  "indexed": true,
  "repo": "my-project",
  "path": "/home/user/projects/my-project",
  "last_commit": "abc123",
  "head_commit": "def456",
  "stale": true,
  "stats": {
    "symbols": 1234,
    "relationships": 5678,
    "processes": 42,
    "embeddings": 0
  }
}
```

## Step 3 — Present Results

| | |
|--|--|
| **Repo** | my-project |
| **Indexed** | ✅ Yes |
| **Stale** | ⚠️ Yes (3 commits behind) |
| **Symbols** | 1,234 |
| **Relationships** | 5,678 |
| **Processes** | 42 |
| **Embeddings** | No |

**Stale index detected** → recommend: `/gitnexus-analyze` to refresh.

**Not indexed** → recommend: `/gitnexus-analyze` to create index.

## Edge Cases

- `indexed: false` → repo not indexed, suggest `/gitnexus-analyze`
- `stale: true` → graph is behind HEAD, warn user
- Outside git repo → error message, suggest cd to repo

$ARGUMENTS