# Kommandozeile tm von Time Momentum einrichten

Anleitung für KI-Agenten (Claude Code, Cursor, Codex). Mit tm bedienst du Time Momentum im Auftrag des Menschen: Zeiten, Kunden, Projekte, Aufträge, Rechnungen, Zahlungen und Auswertungen.

## 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 auth login` 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 anmelden lassen

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

```
tm auth login
```

Der Befehl fragt verdeckt nach dem API-Key. Den Key legt der Mensch in Time Momentum unter Datenquellen › CLI an: mit Leserecht für Projekte und Zeiten, mit Schreibrecht für alles andere. Findet das neue Terminal tm nicht, nenn dem Menschen den vollen Pfad. Warte, bis er fertig ist.

## 4. Prüfen

`tm whoami --json` zeigt Workspace und Berechtigung (`read` oder `write`).

## 5. Anleitung für künftige Aufträge einrichten

- Claude Code: `tm skill --install` richtet den Skill „time-momentum“ ein.
- Andere Agenten: `tm skill` lesen und das Wichtigste in die dauerhaften Anweisungen übernehmen.

## 6. Ergebnis melden

Sag dem Menschen kurz, ob alles geklappt hat.

## Bei Problemen

- `command not found: tm`: voller Pfad oder neues Terminal.
- Exit 3 (`unauthorized`): Der Key ist ungültig oder widerrufen. Der Mensch legt einen neuen an.
- Alle Befehle: `tm --json`, Details je Gruppe: `tm schema <gruppe> --json`.