Files

T

tomasz-syn-grzegorza 287c08ebfc Add universal GitNexus skills for Cursor and Hermes.

Consolidate connect, graph, and search workflows with mobile endpoint defaults and shared installation docs.

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

2026-07-01 16:08:15 +02:00

3.3 KiB

Raw Permalink Blame History

Workspace skills (`$HOME/Pulpit/cursor/skills`)

Wspólne skille dla Cursor i Hermes w ekosystemie agency-ai.

Domyślna ścieżka:

SKILLS_ROOT="${SKILLS_ROOT:-$HOME/Pulpit/cursor/skills}"

Skille GitNexus

Skill	Wywołanie / trigger	Opis
gitnexus-connect	setup MCP, health check, problemy z połączeniem	Bootstrap połączenia z `gitnexus.mobile.agency-ai.dev`
gitnexus-graph	architektura, zależności, impact, refaktoryzacja	Graph-first: `query` / `context` / `impact` przez MCP
gitnexus-search	`gitnexus-search <repo> <prompt...>`	Jawne wyszukiwanie po nazwie repo + prompt

Endpointy

Zastosowanie	Zdalny (domyślny)	Lokalny (dev na hoście GitNexus)
MCP	`https://gitnexus.mobile.agency-ai.dev/api/mcp`	`http://127.0.0.1:4747/api/mcp`
REST API	`https://gitnexus.mobile.agency-ai.dev`	`http://127.0.0.1:4747`
UI (opcjonalnie)	osobna subdomena → 4173	`http://127.0.0.1:4173`

Szczegóły: gitnexus-connect/reference.md.

Cursor — instalacja

Symlinki do skilli (po sklonowaniu repo):

SKILLS_ROOT="$HOME/Pulpit/cursor/skills"
mkdir -p ~/.cursor/skills

ln -sfn "$SKILLS_ROOT/gitnexus-connect" ~/.cursor/skills/gitnexus-connect
ln -sfn "$SKILLS_ROOT/gitnexus-graph"    ~/.cursor/skills/gitnexus-graph
ln -sfn "$SKILLS_ROOT/gitnexus-search"   ~/.cursor/skills/gitnexus-search

MCP w ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gitnexus": {
      "url": "https://gitnexus.mobile.agency-ai.dev/api/mcp"
    }
  }
}

Lokalnie (ten sam host co Docker): zamień URL na http://127.0.0.1:4747/api/mcp.

Po symlinku: Reload Window + nowa sesja chatu.

Health check:

bash "$SKILLS_ROOT/gitnexus-connect/scripts/gitnexus-health.sh"

Hermes — instalacja

W promptcie systemowym lub INSTALL-AGENT.md podaj ścieżki do skilli:

$SKILLS_ROOT/gitnexus-connect/SKILL.md
$SKILLS_ROOT/gitnexus-graph/SKILL.md
$SKILLS_ROOT/gitnexus-search/SKILL.md

Zmienne środowiskowe:

export GITNEXUS_SERVER_URL=https://gitnexus.mobile.agency-ai.dev
export GITNEXUS_DEFAULT_REPO=one-gateway
export SKILLS_ROOT="$HOME/Pulpit/cursor/skills"

Hermes używa MCP HTTP (ten sam URL co Cursor) lub REST fallback:

python3 "$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py" \
  one-gateway "deploy_runner"

Więcej: one-gateway/docs/hermes/GITNEXUS-CLIENT.md.

Przykłady

gitnexus-search ai-lawyer-srvr routes_paperless admin
gitnexus-search gateway gitnexus_workspace_dir

Extended documentation (one-gateway)

Szczegółowa dokumentacja deployu i operatora — w repo one-gateway:

coding-agent/31-gitnexus-deployment-report.md
coding-agent/33-gitnexus-m3gan-remote-client.md
coding-agent/34-gitnexus-npmplus-edge-setup.md
coding-agent/35-cursor-gitnexus-mcp-setup.md
coding-agent/36-gitnexus-repo-connection-guide.md

Canonical source skilli: ten katalog (cursor/skills). Kopia one-gateway/.cursor/skills/gitnexus-graph-first nie jest utrzymywana — używaj gitnexus-graph stąd.

3.3 KiB Raw Permalink Blame History

Workspace skills ($HOME/Pulpit/cursor/skills)