# Query

> GitNexus Query

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

---


# GitNexus Query

Search the knowledge graph for execution flows and symbols related to a concept. Returns processes (call chains) ranked by relevance.

## Entry

```
/gitnexus-query "authentication flow"
/gitnexus-query "error handling" --limit 10
/gitnexus-query "database connection" --content  # include source code
```

¬query → ask user provide a search term.

## Step 0 — Pre-flight

```bash
gitnexus status
```

¬indexed → ask user run `/gitnexus-analyze` first.

Index stale → warn user, suggest re-indexing.

## Step 1 — Run Query

```bash
gitnexus query "$QUERY" $FLAGS
```

| Flag | Effect |
|------|--------|
| `--limit N` | Max processes to return (default: 5) |
| `--content` | Include full symbol source code |
| `--context "text"` | Task context for better ranking |
| `--goal "text"` | What you want to find |
| `--repo <name>` | Target specific repo if multiple indexed |

## Step 2 — Parse JSON Output

```json
{
  "processes": [
    {
      "name": "LoginFlow",
      "relevance": 0.95,
      "symbols": ["loginHandler", "validateUser", "createSession"]
    }
  ],
  "process_symbols": [...],
  "definitions": [...]
}
```

## Step 3 — Present Results

**Processes (execution flows):**

| Process | Relevance | Key Symbols |
|---------|-----------|-------------|
| LoginFlow | 0.95 | loginHandler, validateUser, createSession |
| TokenRefresh | 0.78 | refreshToken, verifyToken |

**Standalone definitions:** types/interfaces not in any process.

## Step 4 — Follow-up

- Want full symbol context → `/gitnexus-context <symbol>`
- Want blast radius → `/gitnexus-impact <symbol>`
- Want full process trace → `gitnexus://repo/{name}/process/{processName}` (requires MCP)

$ARGUMENTS