# Recallbase-Setup — Anweisungen für KI-Agenten

Du richtest Recallbase ein: ein persistentes Gedächtnis für Claude Code.
Der Nutzer hat dir seinen API-Key gegeben (Format `brain_…`). Falls nicht,
frage zuerst danach — ohne Key kein Setup. Führe die Schritte in Reihenfolge
aus und verifiziere am Ende.

## Schritt 1: Voraussetzungen prüfen

```bash
node --version   # muss >= 18 sein
```

Falls Node fehlt oder zu alt ist: stoppe und sage dem Nutzer, dass Node.js 18+
installiert werden muss.

## Schritt 2: Client herunterladen und entpacken

Ziel: `~/.claude/brain-helper/dist/` (Windows: `%USERPROFILE%\.claude\brain-helper\dist\`).

**Windows (PowerShell):**
```powershell
Invoke-WebRequest https://recallbase.de/download/recallbase-client.zip -OutFile "$env:TEMP\recallbase-client.zip"
Expand-Archive "$env:TEMP\recallbase-client.zip" "$env:USERPROFILE\.claude\brain-helper\dist" -Force
```

**macOS / Linux:**
```bash
mkdir -p ~/.claude/brain-helper/dist
curl -fsSL https://recallbase.de/download/recallbase-client.zip -o /tmp/recallbase-client.zip
unzip -o /tmp/recallbase-client.zip -d ~/.claude/brain-helper/dist
```

## Schritt 3: Konfiguration schreiben

Erstelle `~/.claude/brain-config.json`. Existiert die Datei bereits, frage den
Nutzer, bevor du sie überschreibst. Als `clientName` nimm den Hostnamen des
Rechners (Großbuchstaben, keine Leerzeichen):

```json
{
  "apiUrl": "https://api.recallbase.de/api",
  "apiKey": "<API-KEY DES NUTZERS>",
  "clientName": "<HOSTNAME>"
}
```

## Schritt 4: Hooks in settings.json eintragen

Datei: `~/.claude/settings.json`.

**WICHTIG: Vorhandene Inhalte erhalten.** Lies die Datei zuerst. Existiert
bereits ein `hooks`-Block, ergänze die drei Einträge, ohne bestehende Hooks
zu löschen. Existiert die Datei nicht, lege sie mit genau diesem Inhalt an.
Ersetze `<HELPER>` durch den absoluten Pfad zu
`.claude/brain-helper/dist/index.js` im Home-Verzeichnis (unter Windows mit
doppelten Backslashes).

```json
{
  "hooks": {
    "SessionStart": [{ "hooks": [{ "type": "command", "command": "node \"<HELPER>\" session-start", "timeout": 15 }] }],
    "Stop":         [{ "hooks": [{ "type": "command", "command": "node \"<HELPER>\" turn-end",      "timeout": 10 }] }],
    "SessionEnd":   [{ "hooks": [{ "type": "command", "command": "node \"<HELPER>\" session-end",   "timeout": 10 }] }]
  }
}
```

## Schritt 5 (empfohlen): Brain-Befehle installieren

```bash
curl -fsSL https://recallbase.de/download/brain-skill.md -o ~/.claude/commands/brain.md
```
(Windows: nach `%USERPROFILE%\.claude\commands\brain.md` speichern; Ordner ggf. anlegen.)

## Schritt 6: Erstes Projekt verbinden

Im Projektordner des Nutzers (frage, welcher es sein soll, falls unklar):

```bash
node ~/.claude/brain-helper/dist/index.js init
```

Erwartete Ausgabe: `Projekt "<name>" angelegt (ID <n>) und mit diesem Ordner verknuepft.`
Bei `Plan-Limit erreicht`: dem Nutzer den Upgrade-Hinweis zeigen.

## Schritt 7: Verifizieren

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

`version` muss eine Versionsnummer ausgeben. `sessions` muss das eben angelegte
Projekt nennen (auch „0 Sessions" ist korrekt). Bei Fehlern:
`~/.claude/brain-helper/log.txt` lesen — `401` bedeutet falscher API-Key.

## Abschluss

Sage dem Nutzer:
- Setup ist fertig; die nächste Claude-Code-Session in diesem Ordner lädt
  automatisch einen `<brain-context>`-Block mit Projekt-Gedächtnis.
- Ein API-Key pro Rechner ist empfohlen (weitere unter recallbase.de/account).
- Dokumentation: https://recallbase.de/docs.html