From 361cd25212bac22713d3eaa3976a92bfa92ab05b Mon Sep 17 00:00:00 2001 From: "l.kirchner" Date: Tue, 2 Jun 2026 15:10:45 +0200 Subject: [PATCH] docs: wiki Installation --- Installation.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 Installation.md diff --git a/Installation.md b/Installation.md new file mode 100644 index 0000000..a8ab76e --- /dev/null +++ b/Installation.md @@ -0,0 +1,40 @@ +# Installation + +## Voraussetzungen + +- **Claude Code** mit Plugin-Unterstützung. +- Für `knowledge-curator` zusätzlich ein verbundener **MCP-Memory-Server** (Knowledge-Graph-Typ). Default-Erwartung: Server-Name `memory` mit den Tools `mcp__memory__read_graph`, `mcp__memory__search_nodes`, `mcp__memory__open_nodes` (read) sowie `mcp__memory__create_entities`/`create_relations`/`add_observations` und `delete_entities`/`delete_relations`/`delete_observations` (write). + +## Marketplace hinzufügen und installieren + +In Claude Code: + +``` +/plugin marketplace add https://gitea.luki-net.org/l.kirchner/claude-marketplace.git +/plugin install knowledge-curator@luki-net +/plugin install venture@luki-net +``` + +Die `.git`-URL erzwingt einen Klon (Direkt-Fetch der HTML-Seite scheitert). Der Marketplace heißt intern `luki-net` — daher `@luki-net`. + +## Nach der Installation + +- Skill-Änderungen greifen sofort; Änderungen an `agents/`, `commands/`, `hooks/` brauchen **`/reload-plugins`** oder einen Neustart von Claude Code. +- **MCP-Tool-Namen prüfen:** Heißt dein Server nicht `memory` oder nutzt andere Tool-Namen (z. B. `search_memories` / `find_memories_by_name`), die `tools:`-Whitelists in `knowledge-curator/agents/*.md`, den Matcher in `hooks/hooks.json` und das `SKILL.md` anpassen. Check mit `claude mcp list` bzw. `/mcp`. + +## Backup-Hook konfigurieren (knowledge-curator) + +Der PreToolUse-Hook `backup-memory.sh` sichert die Memory-Graph-Datei vor jedem Memory-Write. Steuerung per Env-Variablen (alle optional): + +| Variable | Bedeutung | Default | +|---|---|---| +| `KG_MEMORY_FILE` | Pfad zur JSON-Datendatei des Memory-Servers (Fallback: `MEMORY_FILE_PATH`) | — | +| `KG_BACKUP_DIR` | Zielverzeichnis der Backups | `~/.claude/kg-backups` | +| `KG_BACKUP_DEBOUNCE` | Sekunden; überspringt, wenn jüngeres Backup existiert | `120` | +| `KG_BACKUP_KEEP` | Anzahl behaltener Backups | `20` | + +Ohne `KG_MEMORY_FILE`/`MEMORY_FILE_PATH` protokolliert der Hook einen Hinweis und beendet sauber — er **blockiert den Write nie** (Exit 0). + +## Schneller Test ohne Marketplace + +`./install.sh local` kopiert Skill, Agents und Commands direkt nach `~/.claude/`. Danach Claude Code neu starten bzw. `/reload-plugins`. Siehe [Development](Development).