docs: wiki Installation

2026-06-02 15:10:45 +02:00
parent a4500d87aa
commit 361cd25212
+40
@@ -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).