# Agent-Kollektor von Time Momentum einrichten

Anleitung für KI-Agenten (Claude Code, Cursor, Codex). Der Agent-Kollektor erfasst Zeit, Modell und Token der KI-Coding-Sessions des Menschen über die Hooks von Claude Code, Cursor und Codex und meldet sie an Time Momentum. Quelltext, Dateinamen und Konversationen überträgt er nicht.

## Regel: Der API-Key gehört nicht in die Unterhaltung

- Frag den Menschen nie nach dem API-Key. Lies ihn nirgends aus (Zwischenablage, Konfigurationsdateien, Umgebungsvariablen) und gib ihn nie aus.
- Führe `tm collect init` nicht selbst aus. Es fragt den Key verdeckt ab, und das geht nur in einem echten Terminal. Der Mensch führt es in einem eigenen Terminal aus.

## 1. Node.js prüfen

`node -v` muss mindestens 22.14 zeigen. Fehlt Node.js oder ist es älter, frag den Menschen, bevor du es installierst oder aktualisierst (macOS: `brew install node`, sonst https://nodejs.org).

## 2. tm installieren

- macOS und Linux: `curl -fsSL https://app.time-momentum.com/install-cli.sh | sh`
- Windows (PowerShell): `irm https://app.time-momentum.com/install-cli.ps1 | iex`

Ist tm schon installiert (`tm version`), genügt `tm update`. Der Installer trägt das Verzeichnis von tm in den PATH ein; deine laufende Shell sieht das noch nicht. Ruf tm in deiner Sitzung über den vollen Pfad auf: `~/.time-momentum/bin/tm` (Windows: `%USERPROFILE%\.time-momentum\bin\tm.cmd`).

## 3. Den Menschen verbinden lassen

Bitte den Menschen, ein neues Terminal-Fenster zu öffnen (außerhalb deiner Sitzung) und dort auszuführen:

```
tm collect init
```

Der Befehl fragt verdeckt nach dem API-Key, lässt die Werkzeuge wählen und fragt, ob Abo-Limits gemeldet werden sollen. Den Key legt der Mensch in Time Momentum unter Datenquellen › Agent-Kollektor an. Fremde Hooks bleiben erhalten, vor jeder Änderung entsteht eine `.bak`-Datei. Lehnt der Server den Key ab, endet der Befehl mit Exit 3 und ändert nichts. Findet das neue Terminal tm nicht, nenn dem Menschen den vollen Pfad. Warte, bis er fertig ist.

## 4. Prüfen

- `tm collect status --json`: `api_key` muss `true` sein, `tools` zeigt die verbundenen Werkzeuge.
- Den ersten Versand samt vorhandener Sessions anstoßen: `tm collect sync`.
- Die Sessions erscheinen in Time Momentum unter KI-Sessions; die Einrichtungsseite zeigt dann „Verbunden“.

## 5. Ergebnis melden

Sag dem Menschen kurz, welche Werkzeuge verbunden sind und ob etwas fehlgeschlagen ist.

## Bei Problemen

- `command not found: tm`: voller Pfad oder neues Terminal.
- Exit 3 bei `tm collect init`: Der Key ist ungültig oder widerrufen. Der Mensch legt einen neuen an.
- Weitere Befehle: `tm collect --help`, Anleitung für Agenten: `tm skill`.