Verbinde Time Momentum mit deinen Werkzeugen.

Die Kommandozeile tm, der Agent-Kollektor für Claude Code, Codex und Cursor, Anleitungen, denen dein KI-Agent folgt, und die REST-API dahinter.

  • macOS, Linux und Windows
  • Node.js ab 22.14

Lass deinen KI-Agenten einrichten.

Gib Claude Code, Codex oder Cursor einen Satz. Der Agent liest die Anleitung, prüft Node.js, installiert tm und bittet dich dann, in einem eigenen Terminal zu verbinden. Dort gibst du den API-Key ein, so taucht er nie in der Unterhaltung auf.

Richte auf diesem Rechner den Agent-Kollektor von Time Momentum ein. Lies dafür diese Anleitung und folge ihr: https://www.time-momentum.de/agents/collector.md

Anleitungen für Agenten als Markdown: Agent-Kollektor und Kommandozeile tm. Denselben Prompt zeigen die Einrichtungsseiten in der App.

Erfasse deine KI-Sessions.

Der Agent-Kollektor erfasst Zeit, Modell und Verbrauch jeder Session in Claude Code, Codex und Cursor über deren Hooks. Auch in Free.

  1. tm installieren

    Windows (PowerShell): irm https://app.time-momentum.com/install-cli.ps1 | iex. Danach ein neues Terminal öffnen.

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. API-Key anlegen

    In der App unter Datenquellen › Agent-Kollektor. Er steht nur einmal im Klartext da.

  3. Verbinden

    Fragt verdeckt nach dem Key, dann nach den Werkzeugen und ob Abo-Limits gemeldet werden. Ein abgelehnter Key ändert nichts.

    tm collect init
  4. Prüfen

    tm collect status

Deinen Rechner verlassen nur Messwerte: Zeit, Modell, Verbrauch, Ordner und Commits. Nie Quelltext oder Dateinamen; von der Konversation höchstens ein Titel der Session, und der ist abschaltbar.

Arbeite mit der Kommandozeile.

Ein Key mit Leserecht reicht für Projekte und Zeiten. Alles andere braucht Lesen und Schreiben, das ist Teil von Pro.

  1. tm installieren

    Entfällt, wenn der Kollektor es schon installiert hat.

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. Anmelden

    Den Key legst du in der App unter Datenquellen › CLI an. tm fragt ihn verdeckt ab.

    tm auth login
  3. Anmeldung und Berechtigung prüfen

    tm whoami
  4. Claude Code: Skill einrichten

    tm skill --install
  5. Claude Code: Statuszeile

    Projekt, Aufwand und Budget der laufenden Session unten in Claude Code.

    tm statusline install

Oder ohne Installation, etwa in einer Agenten-Sandbox: npx -y @time-momentum/cli@latest whoami

Plugin für Claude Code.

Bringt denselben Skill und den Befehl /time-momentum:setup mit. Beide Befehle in Claude Code eingeben.

  1. Marktplatz hinzufügen

    /plugin marketplace add https://time-momentum.com/claude/marketplace.json
  2. Plugin installieren

    /plugin install time-momentum@time-momentum

Befehlsgruppen.

Jede Operation der API hat genau einen Befehl. tm schema <gruppe> --json nennt Flags, Typen und Beispiele.

GruppeWofür
tm timersZeiten starten, pausieren, stoppen und nachtragen
tm customers, tm projects, tm ordersKunden, Projekte mit Budget, Aufträge und ihre Abrechnungsart
tm invoices, tm paymentsRechnungen bauen, stellen und als E-Rechnung exportieren, Zahlungen zuordnen und aufteilen
tm statementsLeistungsnachweise als Anlage zur Rechnung oder für sich
tm ai-sessions, tm progressAgenten-Sessions mit Laufzeit und Verbrauch, Projektfortschritt
tm revenue, tm dashboard, tm exportRentabilität, Kennzahlen und Rohdaten als CSV oder Excel
tm collectDer Agent-Kollektor: Werkzeuge verbinden, synchronisieren, Abo-Limits
tm apiJeder Endpunkt direkt, angemeldet wie jeder andere Befehl

REST-API.

tm ist ein Client der REST-API unter https://app.time-momentum.com/api/v1. Fachlogik wie Summen, Steuern und Rechnungsnummern rechnet der Server, Skripte und Agenten bekommen also dieselben Ergebnisse wie die Web-App.

Ein API-Key (tmk_…) gilt direkt als Bearer-Token auf den Lese-Routen, den Timern und dem Ingest des Kollektors. Einen Key mit Schreibrecht tauscht POST /api/v1/auth/token gegen ein Token, das eine Stunde gilt. tm erledigt das für dich und erneuert es selbst.

Keys entstehen nur in der Web-App und lassen sich dort jederzeit widerrufen. Keys anlegen oder das Konto löschen lehnt der Server für den Agentenzugang ab.

Jede Operation mit Parametern, Anfrage- und Antwortschema: OpenAPI-Spezifikation (OpenAPI 3.1).

Für Agenten und Skripte.

  • llms.txt: Seiten und Einrichtungsanleitungen dieser Website in einer Datei
  • agents/collector.md und agents/cli.md: Einrichtungsanleitungen für KI-Agenten
  • tm --json: kompakte Übersicht aller Befehlsgruppen, Konventionen und Exit-Codes
  • openapi.yaml: die REST-API als OpenAPI 3.1
  • tm schema --json: der vollständige Befehlskatalog mit Flags, Typen und Endpunkten
  • tm skill: die Anleitung für Agenten, passend zur installierten Version

Verbinde heute deine Werkzeuge.

  • 30 Tage Pro testen
  • Ohne Kreditkarte
  • Danach weiter mit Free

Häufige Fragen

Brauche ich Pro?

Agent-Kollektor, Timer und Projektliste gehen in Free. Schreibzugriff für Kommandozeile und Agenten, Rechnungen und die übrigen Funktionen sind Teil von Pro, das jedes neue Konto 30 Tage testet.

Warum fragt mein Agent nicht nach dem API-Key?

Damit der Key nie in der Unterhaltung landet. Der Agent installiert tm und bittet dich, tm collect init oder tm auth login in einem eigenen Terminal auszuführen, wo du den Key verdeckt eingibst.

Gibt es einen MCP-Server?

Nein. Dein Agent arbeitet ohnehin in einer Shell, und tm lädt nur den Teil des Befehlskatalogs, den er braucht. Mehr im Ratgeber MCP oder CLI.