tomasz-syn-grzegorza
287c08ebfc
Consolidate connect, graph, and search workflows with mobile endpoint defaults and shared installation docs. Co-authored-by: Cursor <cursoragent@cursor.com>
109 lines
3.3 KiB
Markdown
109 lines
3.3 KiB
Markdown
# Workspace skills (`$HOME/Pulpit/cursor/skills`)
|
|
|
|
Wspólne skille dla **Cursor** i **Hermes** w ekosystemie agency-ai.
|
|
|
|
Domyślna ścieżka:
|
|
|
|
```bash
|
|
SKILLS_ROOT="${SKILLS_ROOT:-$HOME/Pulpit/cursor/skills}"
|
|
```
|
|
|
|
## Skille GitNexus
|
|
|
|
| Skill | Wywołanie / trigger | Opis |
|
|
|-------|---------------------|------|
|
|
| [gitnexus-connect](gitnexus-connect/SKILL.md) | setup MCP, health check, problemy z połączeniem | Bootstrap połączenia z `gitnexus.mobile.agency-ai.dev` |
|
|
| [gitnexus-graph](gitnexus-graph/SKILL.md) | architektura, zależności, impact, refaktoryzacja | Graph-first: `query` / `context` / `impact` przez MCP |
|
|
| [gitnexus-search](gitnexus-search/SKILL.md) | `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](gitnexus-connect/reference.md).
|
|
|
|
## Cursor — instalacja
|
|
|
|
Symlinki do skilli (po sklonowaniu repo):
|
|
|
|
```bash
|
|
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`:
|
|
|
|
```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
|
|
bash "$SKILLS_ROOT/gitnexus-connect/scripts/gitnexus-health.sh"
|
|
```
|
|
|
|
## Hermes — instalacja
|
|
|
|
W promptcie systemowym lub `INSTALL-AGENT.md` podaj ścieżki do skilli:
|
|
|
|
```text
|
|
$SKILLS_ROOT/gitnexus-connect/SKILL.md
|
|
$SKILLS_ROOT/gitnexus-graph/SKILL.md
|
|
$SKILLS_ROOT/gitnexus-search/SKILL.md
|
|
```
|
|
|
|
Zmienne środowiskowe:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
python3 "$SKILLS_ROOT/gitnexus-search/scripts/gitnexus-search.py" \
|
|
one-gateway "deploy_runner"
|
|
```
|
|
|
|
Więcej: [one-gateway/docs/hermes/GITNEXUS-CLIENT.md](../one-gateway/docs/hermes/GITNEXUS-CLIENT.md).
|
|
|
|
## Przykłady
|
|
|
|
```text
|
|
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.
|