# Brain - Recallbase-Befehle fuer Claude Code

Diese Datei nach `~/.claude/commands/brain.md` kopieren. Danach kennt Claude
den Befehl `/brain` und kann dein Recallbase-Gedaechtnis aktiv nutzen.

Der SessionStart-Hook laedt den Projekt-Kontext automatisch - `/brain` brauchst
du nur fuer die Unterbefehle unten.

## `/brain search <begriffe>`
Volltextsuche ueber alle Session-Zusammenfassungen. Nutze das bei Fragen wie
"hatten wir das schonmal?" oder "wo haben wir X geloest?".

```bash
node ~/.claude/brain-helper/dist/index.js search <begriffe>
node ~/.claude/brain-helper/dist/index.js search <begriffe> --all       # alle Projekte
node ~/.claude/brain-helper/dist/index.js search <frage> --semantic     # Bedeutungssuche
```

## `/brain sessions`
Session-Historie des aktuellen Projekts anzeigen (aelteste zuerst):

```bash
node ~/.claude/brain-helper/dist/index.js sessions --count 50
```

## Session-Zusammenfassung speichern
Am Ende einer Arbeitssession: fasse die Session strukturiert zusammen
(`Session DD.MM.YYYY - Titel` + Markdown-Abschnitte) und speichere sie in den
bestehenden Hook-Record. Die Record-ID steht in
`~/.claude/brain-helper/state-session-<session-id>.json` als `sessionRecordId`:

```bash
curl -s -X PATCH "https://api.recallbase.de/api/sessions/<sessionRecordId>" \
  -H "Authorization: Bearer <API_KEY aus brain-config.json>" \
  -H "Content-Type: application/json" \
  -d '{"zusammenfassung": "<Zusammenfassung>", "status": "completed"}'
```

Wichtig: PATCHen, nicht neu anlegen - sonst entstehen Duplikate.

## `/brain consolidate`
Destilliert die Session-Historie in dauerhafte Knowledge Nodes.

Schritt 0 - abgestuerzte Sessions nachverdichten:
```bash
node ~/.claude/brain-helper/dist/index.js distill list
node ~/.claude/brain-helper/dist/index.js distill fetch <sessionId>
# Transcript lesen, Zusammenfassung schreiben, dann:
node ~/.claude/brain-helper/dist/index.js distill done <sessionId> << 'EOF'
Session DD.MM.YYYY - <Titel>
...
EOF
```

Dann: wiederkehrende Muster aus den Sessions als Wissen sichern
(Lessons, Patterns, Tech-Entscheidungen - Qualitaet vor Menge):
```bash
node ~/.claude/brain-helper/dist/index.js knowledge-add --type <lesson|pattern|technology|concept> --title "<Titel>" --tags "thema" --confidence 0.8 << 'EOF'
<Erkenntnis in 2-5 Saetzen>
EOF
```

## `/brain exit`
Session manuell beenden (macht der SessionEnd-Hook normalerweise automatisch):
```bash
node ~/.claude/brain-helper/dist/index.js session-end < /dev/null
```

## Hook-Verhalten (Referenz)
- SessionStart -> Kontext laden + Projekt-Lock
- Stop (nach jedem Turn) -> Session-Update, Heartbeat, Transcript-Sicherung
- SessionEnd -> Lock freigeben, Session finalisieren

Logs bei Problemen: `~/.claude/brain-helper/log.txt`