feat: local Ollama backend for /understand and /understand-ollama

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "understand-anything",
   "description": "AI-powered codebase understanding — analyze, visualize, and explain any project",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "author": {
     "name": "Egonex"
   },

.copilot-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "understand-anything",
   "description": "AI-powered codebase understanding — analyze, visualize, and explain any project",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "author": {
     "name": "Egonex"
   },

.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "understand-anything",
   "displayName": "Understand Anything",
   "description": "AI-powered codebase understanding — analyze, visualize, and explain any project",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "author": {
     "name": "Egonex"
   },

.gitignore

@@ -1,6 +1,7 @@
 node_modules
 dist
 .understand-anything
+graphify-out/
 *.tsbuildinfo
 .DS_Store
 .env

README.md

@@ -184,6 +184,26 @@ An interactive web dashboard opens with your codebase visualized as a graph —
 /understand src/frontend
 ```
 
+### 5. Run fully locally with Ollama
+
+Prefer to keep every byte on your machine? Use a local Ollama server. Ollama ships [native integrations](https://docs.ollama.com/integrations) for several hosts in the list above — Claude Code, Codex App, Codex CLI, Copilot CLI, Cline CLI, OpenCode, VS Code (incl. Copilot), JetBrains, Zed, Roo Code — and you should use the native integration when one exists.
+
+For hosts with no native Ollama integration (Cursor, Gemini CLI, OpenClaw, Hermes, Goose, Kiro CLI / IDE, Antigravity, Pi Agent, Vibe CLI, Trae, Nanobot, Droid, Pool, …), or when you want a guarantee that no prompt ever leaves the host machine, use `/understand-ollama`:
+
+```bash
+# One-time setup
+curl -fsSL https://ollama.com/install.sh | sh   # install Ollama
+ollama serve &                                   # start the server
+ollama pull qwen2.5-coder:7b                    # pull a 7B code model
+
+# Then run
+/understand-ollama
+# or
+/understand --ollama
+```
+
+The local pipeline produces the same `.understand-anything/knowledge-graph.json` schema and the same dashboard. See `understand-anything-plugin/skills/understand-ollama/SKILL.md` for details on which path is right for your host.
+
 ---
 
 ## 🌐 Multi-Platform Installation
@@ -254,7 +274,7 @@ For personal skills (available across all projects), run the `install.sh` above
 | Platform | Status | Install Method |
 |----------|--------|----------------|
 | Claude Code | ✅ Native | Plugin marketplace |
-| Cursor | ✅ Supported | Auto-discovery |
+| Ollama (local) | ✅ Supported | `/understand-ollama` (no host plugin needed) |
 | VS Code + GitHub Copilot | ✅ Supported | Auto-discovery |
 | Copilot CLI | ✅ Supported | Plugin install |
 | Codex | ✅ Supported | `install.sh codex` |

READMEs/README.ollama.md

@@ -0,0 +1,39 @@
+# Understand Anything — Local Ollama Backend
+
+> Local-first variant of Understand Anything. Runs the full pipeline against a user-run [Ollama](https://ollama.com) server. No API key, no cloud egress, no host-plugin required.
+
+## Where to look
+
+- **Main README:** [README.md](../README.md) — overview, multi-platform install, dashboard, all skills.
+- **Local-only quick start:** [README.md → Run fully locally with Ollama](../README.md#5-run-fully-locally-with-ollama).
+- **Skill definition:** [`understand-anything-plugin/skills/understand-ollama/SKILL.md`](../understand-anything-plugin/skills/understand-ollama/SKILL.md) — prerequisites, CLI flags, how the seven phases run against Ollama.
+- **Implementation plan:** [`docs/superpowers/plans/2026-06-19-ollama-backend-impl.md`](../docs/superpowers/plans/2026-06-19-ollama-backend-impl.md).
+- **Design spec:** [`docs/superpowers/specs/2026-06-19-ollama-backend-design.md`](../docs/superpowers/specs/2026-06-19-ollama-backend-design.md).
+
+## TL;DR
+
+```bash
+# One-time setup
+curl -fsSL https://ollama.com/install.sh | sh
+ollama serve &
+ollama pull qwen2.5-coder:7b    # 7B default; works on a 16 GB GPU
+
+# Per project
+node understand-anything-plugin/skills/understand-ollama/run-pipeline.mjs \
+  --project-root "$(pwd)" \
+  --plugin-root "$(pwd)/understand-anything-plugin" \
+  --model qwen2.5-coder:7b
+```
+
+The script writes the same `.understand-anything/knowledge-graph.json` and `.understand-anything/meta.json` files that the host-plugin path produces. Run any of the standard dashboard / diff / chat skills afterward to explore the result.
+
+## Status
+
+Production-ready. Tested end-to-end against the local Ollama server on the `homepage/` fixture and on the `Understand-Anything` monorepo itself, using the 1.5B default model (small CPU/laptop footprint) and the 7B code model (consumer GPU). Schema validation passes against the dashboard's Zod schema.
+
+## Differences from the host-plugin path
+
+- Project narrative, per-file enrichment, layer detection, and tour generation call Ollama directly. The host-plugin path delegates these to host-platform subagents (Claude Code, Cursor, Copilot).
+- `--review` runs structural validation only. The host-plugin path's graph-reviewer subagent is a host-platform LLM call; on the local path the run continues with warnings surfaced.
+- Concurrency is bounded by the local model's memory budget. Default is 2 concurrent requests.
+- Default model is `qwen2.5-coder:1.5b` (fast, low-memory); switch to `qwen2.5-coder:7b` or `qwen3-coder:30b` for higher-quality output on beefier hardware.