---
name: gitnexus-search
description: >-
  Przeszukuje zdalny GitNexus po nazwie repo i promptcie użytkownika.
  Użyj gdy użytkownik wywołuje skill gitnexus-search, @gitnexus-search,
  lub podaje repo + zapytanie do grafu kodu (search, symbole, flow).
disable-model-invocation: true
---

# gitnexus-search

Jawne wyszukiwanie w zdalnym GitNexus (`https://gitnexus.mobile.agency-ai.dev`). Działa w **Cursor** (MCP) i **Hermes** (REST).

## Format wejścia

```text
gitnexus-search <repo> <prompt...>
```

- Pierwszy token po nazwie skilla = **repo**
- **Cała reszta linii** = prompt wyszukiwania (może zawierać spacje)

Przykłady:

```text
gitnexus-search one-gateway gitnexus_workspace_dir
gitnexus-search ai-lawyer-srvr routes_paperless admin flow
gitnexus-search gateway deploy_runner install path
```

## Aliasy repo

| Użytkownik wpisuje | Repo GitNexus | Ścieżka MCP (przy konflikcie) |
|--------------------|---------------|-------------------------------|
| `one-gateway`, `gateway` | `one-gateway` | `/data/gitnexus/repos/one-gateway` |
| `ai-lawyer-srvr`, `ai-lawyer` | `ai-lawyer-srvr` | `/data/gitnexus/repos/ai-lawyer-srvr` |

Nieznane repo → `list_repos` / `GET /api/repos` i pokaż dostępne nazwy.

## Wykonanie — Cursor (preferowane)

Gdy MCP `gitnexus` jest Connected:

1. `list_repos` — potwierdź, że repo istnieje i ma `stats.files > 0`
2. `query` z argumentami:
   - `search_query`: prompt użytkownika
   - `repo`: znormalizowana nazwa (lub ścieżka bezwzględna z tabeli)
   - `limit`: 10
3. Jeśli prompt sugeruje impact/zależności — opcjonalnie jeden `context` lub `impact` na top symbolu z wyników

## Wykonanie — Hermes / fallback

Gdy MCP niedostępny — **od razu** REST, bez pytania użytkownika:

```bash
python3 /home/test-user/cursor/skills/gitnexus-search/scripts/gitnexus-search.py \
  <repo> "<prompt>"
```

Opcjonalnie: `--limit N`, `--json`.

## Format odpowiedzi

1. **Nagłówek:** repo + prompt (echo)
2. **Tabela** top 5–10 trafień: rank, filePath, score, kluczowe symbole/nodeIds
3. **Synteza:** 1–2 zdania — co wyniki sugerują w architekturze
4. **Następny krok:** `context`/`impact` (MCP), otwarcie pliku lokalnie, lub doprecyzowanie promptu

## Błędy

| Sytuacja | Akcja |
|----------|-------|
| Repo nieznane | Lista z `/api/repos` |
| Indeks pusty (`files: 0`) | Wskazówka: re-index (`gitnexus-index-remote.py` w projekcie) |
| MCP Error / brak narzędzi | REST przez `gitnexus-search.py` |
| HTTP / timeout | `curl -fsS $GITNEXUS_SERVER_URL/api/health` |

## Powiązane

- Skrypt: [`scripts/gitnexus-search.py`](scripts/gitnexus-search.py)
- Hermes: [`one-gateway/docs/hermes/GITNEXUS-CLIENT.md`](../../one-gateway/docs/hermes/GITNEXUS-CLIENT.md)
- Workspace skills: [`../README.md`](../README.md)