Files

T

tomasz-syn-grzegorza fa48844fb3 Add shared workspace skills for Cursor and Hermes.

Introduce gitnexus-search skill with REST CLI for remote GitNexus queries by repo name and prompt.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-01 13:31:03 +00:00

2.7 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
gitnexus-search	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).	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

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

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

Przykłady:

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:

list_repos — potwierdź, że repo istnieje i ma stats.files > 0
query z argumentami:
- search_query: prompt użytkownika
- repo: znormalizowana nazwa (lub ścieżka bezwzględna z tabeli)
- limit: 10
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:

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

Opcjonalnie: --limit N, --json.

Format odpowiedzi

Nagłówek: repo + prompt (echo)
Tabela top 5–10 trafień: rank, filePath, score, kluczowe symbole/nodeIds
Synteza: 1–2 zdania — co wyniki sugerują w architekturze
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
Hermes: one-gateway/docs/hermes/GITNEXUS-CLIENT.md
Workspace skills: ../README.md

2.7 KiB Raw Blame History Unescape Escape