From 284c73c77c408a289716e45840fc1d99a3b8ed90 Mon Sep 17 00:00:00 2001 From: tomasz-syn-grzegorza Date: Sat, 4 Jul 2026 12:28:09 +0200 Subject: [PATCH] Document workspace auto-refresh in GitNexus skills. Co-authored-by: Cursor --- gitnexus-connect/reference.md | 15 +++++++++++++++ gitnexus-graph/SKILL.md | 10 ++++++++++ 2 files changed, 25 insertions(+) diff --git a/gitnexus-connect/reference.md b/gitnexus-connect/reference.md index 83faa58..74ead10 100644 --- a/gitnexus-connect/reference.md +++ b/gitnexus-connect/reference.md @@ -102,6 +102,21 @@ Bez zabezpieczenia publicznie udostępniasz metadane repo, strukturę kodu i wyn | Lokalny 4747 zajęty | `docker ps` — użyj kontenera, nie drugiego `serve` | | Hermes bez MCP | REST: `gitnexus-search/scripts/gitnexus-search.py` | +## LocalAI (HTTP embeddings + chat LLM) + +Opcjonalna integracja z LocalAI OpenAI-compatible API (np. `http://192.168.100.5:8070`): + +| Zmienna | Opis | +|---------|------| +| `GITNEXUS_EMBEDDING_URL` | `http://:8070/v1` — semantic search | +| `GITNEXUS_EMBEDDING_MODEL` | model z `/v1/models` (embeddings) | +| `GITNEXUS_EMBEDDING_DIMS` | wymiar wektora (musi zgadzać się z modelem) | +| `GITNEXUS_EMBEDDING_API_KEY` | Bearer token LocalAI | +| `GITNEXUS_LLM_BASE_URL` | `http://127.0.0.1:18070/v1` przez lokalny proxy (SSRF) | +| `GITNEXUS_API_KEY` / `GITNEXUS_MODEL` | chat / wiki LLM | + +Setup: `one-gateway/coding-agent/37-gitnexus-localai-integration.md` + ## Extended documentation (one-gateway) - `coding-agent/31-gitnexus-deployment-report.md` diff --git a/gitnexus-graph/SKILL.md b/gitnexus-graph/SKILL.md index 8b88d2c..b86bf91 100644 --- a/gitnexus-graph/SKILL.md +++ b/gitnexus-graph/SKILL.md @@ -35,6 +35,14 @@ Graph-first workflow dla **Cursor** (MCP) i **Hermes** (MCP lub REST fallback). 4. Przed refaktoryzacją → `impact` 5. Eksploracja otwarta → `query` +## Workspace auto-refresh (mobile / lokalny Docker) + +Na hoście z mountem `~/Pulpit/cursor` → `/workspace:rw` działa watcher `gitnexus-watch.service` (debounce ~45 s). Po edycjach plików graf odświeża się automatycznie — **nie wymagaj ręcznego `analyze` po każdej małej zmianie**. + +- Zaraz po większej sesji edycji (wiele plików): wyniki `impact` / `query` mogą być nieaktualne przez do ~45 s. +- Po dużym refaktorze możesz wymusić reindex: `POST /api/analyze` z `{"path":"/workspace/","embeddings":true}` lub `docker exec one-gateway-gitnexus-server gitnexus analyze /workspace/ --embeddings`. +- Setup: `one-gateway/coding-agent/38-gitnexus-cursor-workspace.md` + ## Narzędzia MCP | Narzędzie | Zastosowanie | @@ -73,3 +81,5 @@ Przy wielu repo podawaj `repo` explicite (nazwa lub ścieżka bezwzględna z ind - Setup: [`gitnexus-connect`](../gitnexus-connect/SKILL.md) - Jawne wyszukiwanie: [`gitnexus-search`](../gitnexus-search/SKILL.md) - Extended docs: `one-gateway/coding-agent/35-cursor-gitnexus-mcp-setup.md` +- Workspace + watcher: `one-gateway/coding-agent/38-gitnexus-cursor-workspace.md` +