docs: wiki Installation
+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).
|
||||||
Reference in New Issue
Block a user