Collega Time Momentum ai tuoi strumenti.

La riga di comando tm, l'agent collector per Claude Code, Codex e Cursor, guide di configurazione che il tuo agente AI può seguire e la REST API dietro a tutto.

  • macOS, Linux e Windows
  • Node.js 22.14 o successivo

Lascia la configurazione al tuo agente AI.

Incolla una frase in Claude Code, Codex o Cursor. L'agente legge la guida, verifica Node.js, installa tm e poi ti chiede di collegarti in un tuo terminale. Lì inserisci la chiave API, così non compare mai nella conversazione.

Configura l'agent collector di Time Momentum su questo computer. Leggi e segui questa guida: https://www.time-momentum.com/agents/collector.md

Guide per agenti in Markdown (in inglese): agent collector e riga di comando tm. Le pagine di configurazione nell'app mostrano lo stesso prompt.

Rileva le tue sessioni AI.

L'agent collector registra tempo, modello e utilizzo di ogni sessione di Claude Code, Codex e Cursor tramite i loro hook. Anche con Free.

  1. Installa tm

    Windows (PowerShell): irm https://app.time-momentum.com/install-cli.ps1 | iex. Poi apri un nuovo terminale.

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. Crea una chiave API

    Nell'app in Datenquellen › Agent-Kollektor. Viene mostrata una sola volta.

  3. Collega

    Chiede la chiave con input nascosto, poi quali strumenti rilevare e se segnalare i limiti dell'abbonamento. Una chiave rifiutata non cambia nulla.

    tm collect init
  4. Verifica

    tm collect status

Dal tuo computer escono solo misurazioni: tempo, modello, utilizzo, cartelle e commit. Mai codice sorgente o nomi di file; della conversazione al massimo un titolo della sessione, che puoi disattivare.

Lavora con la riga di comando.

Una chiave con accesso in lettura copre progetti e voci di tempo. Tutto il resto richiede accesso in lettura e scrittura, che fa parte di Pro.

  1. Installa tm

    Salta questo passaggio se l'ha già installato il collector.

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

    Crea la chiave nell'app in Datenquellen › CLI. tm la chiede con input nascosto.

    tm auth login
  3. Verifica accesso e permessi

    tm whoami
  4. Claude Code: installa la skill

    tm skill --install
  5. Claude Code: riga di stato

    Progetto, impegno e budget della sessione corrente in fondo a Claude Code.

    tm statusline install

Oppure senza installare, per esempio in una sandbox per agenti: npx -y @time-momentum/cli@latest whoami

Plugin per Claude Code.

Porta la stessa skill più il comando /time-momentum:setup. Esegui entrambi i comandi dentro Claude Code.

  1. Aggiungi il marketplace

    /plugin marketplace add https://time-momentum.com/claude/marketplace.json
  2. Installa il plugin

    /plugin install time-momentum@time-momentum

Gruppi di comandi.

Ogni operazione dell'API ha esattamente un comando. tm schema <group> --json elenca flag, tipi ed esempi.

GruppoCosa copre
tm timersAvviare, mettere in pausa, fermare e registrare voci di tempo
tm customers, tm projects, tm ordersClienti, progetti con budget, commesse e il loro tipo di fatturazione
tm invoices, tm paymentsPreparare, emettere ed esportare fatture come fatture elettroniche, registrare e ripartire pagamenti
tm statementsReport delle attività come allegato alla fattura o a sé
tm ai-sessions, tm progressSessioni degli agenti con tempo di esecuzione e utilizzo, avanzamento del progetto
tm revenue, tm dashboard, tm exportRedditività, indicatori e dati grezzi in CSV o Excel
tm collectL'agent collector: collegare strumenti, sincronizzare, limiti dell'abbonamento
tm apiQualsiasi endpoint direttamente, con lo stesso accesso di ogni altro comando

REST API.

tm è un client della REST API su https://app.time-momentum.com/api/v1. La logica di business, come totali, imposte e numeri di fattura, sta sul server, quindi script e agenti ottengono gli stessi risultati dell'app web.

Una chiave API (tmk_…) funziona direttamente come bearer token sulle route di lettura, sui timer e sull'ingest del collector. Una chiave con accesso in scrittura viene scambiata con un token valido un'ora tramite POST /api/v1/auth/token. tm lo fa per te e lo rinnova automaticamente.

Le chiavi si creano solo nell'app web e lì si possono revocare in qualsiasi momento. Il server rifiuta la creazione di chiavi e l'eliminazione dell'account tramite l'accesso per agenti.

Ogni operazione con parametri e schemi di richiesta e risposta: specifica OpenAPI (OpenAPI 3.1, descrizioni in tedesco).

Per agenti e script.

  • llms.txt: pagine e guide di configurazione di questo sito in un unico file
  • agents/collector.md e agents/cli.md: guide di configurazione per agenti AI
  • tm --json: panoramica compatta di tutti i gruppi di comandi, convenzioni e codici di uscita
  • openapi.yaml: la REST API in formato OpenAPI 3.1
  • tm schema --json: il catalogo completo dei comandi con flag, tipi ed endpoint
  • tm skill: la guida d'uso per agenti, allineata alla versione installata

Collega i tuoi strumenti oggi.

  • 30 giorni di Pro
  • Senza carta di credito
  • Poi continui con Free

Domande frequenti

Mi serve Pro?

L'agent collector, i timer e l'elenco dei progetti funzionano con Free. L'accesso in scrittura per la riga di comando e per il tuo agente, le fatture e le altre funzioni fanno parte di Pro, che ogni nuovo account prova per 30 giorni.

Perché il mio agente non chiede la chiave API?

Così la chiave non finisce mai nella conversazione. L'agente installa tm e ti chiede di eseguire tm collect init o tm auth login in un tuo terminale, dove la chiave si inserisce con input nascosto.

Esiste un server MCP?

No. Il tuo agente lavora già in una shell e tm carica solo la parte del catalogo dei comandi che gli serve. Di più nella guida MCP o CLI per agenti AI.