Document workspace auto-refresh in GitNexus skills.

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

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://<host>: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`

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/<repo>","embeddings":true}` lub `docker exec one-gateway-gitnexus-server gitnexus analyze /workspace/<repo> --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`
+