kg-opslisted

# Knowledge-graph operations runbook Recipes for agents. Each: diagnose → act → verify → undo where it applies. ## Orientation — what runs where - One **shared HTTP MCP server** serves every session: `http://127.0.0.1:8765/` (override port with `KG_HTTP_PORT`). Health: `curl -sf http://127.0.0.1:8765/health`. - Logs: `~/.local/state/knowledge-graph/mcp_server.log`. PID file: `server/.mcp_server.pid` next to `manage_server.sh`. - Data: `~/.knowledge-graph/` (plain JSON — `user.json`, `projects/<slug>/graph.json`, `sessions.json`). Survives uninstall. - Plugin cache dirs are **versioned** (`~/.claude/plugins/cache/maxim-plugins/knowledge-graph/<version>/`) and change on every update. Anything that must survive updates goes through the stable shims in `~/.local/bin/`: `kg-memory`, `kg-visual`, `kg-desktop-bridge`. Never hardcode a versioned cache path into configs. - A SessionStart hook auto-starts the server when it's down. It never stops or restarts a running one. ## Install / first run 1. User installs via `/plugin marketplace add mironmax/claudecode-plugins` → `/plugin install knowledge-graph@maxim-plugins` → restart Claude Code. 2. The start script builds its own Python venv on first run (and rebuilds after updates) — first start can take ~1 min. No manual pip steps. 3. Optional shell commands: ```bash bash "$(find ~/.claude/plugins/cache/maxim-plugins/knowledge-graph -name install_command.sh | sort -V | tail -1)" ``` Symlinks `kg-memo