Conecte o Time Momentum às suas ferramentas.

A linha de comando tm, o coletor de agentes para Claude Code, Codex e Cursor, guias de configuração que seu agente de IA consegue seguir e a API REST por trás de tudo isso.

  • macOS, Linux e Windows
  • Node.js 22.14 ou mais recente

Deixe seu agente de IA fazer a configuração.

Cole uma frase no Claude Code, Codex ou Cursor. O agente lê o guia, verifica o Node.js, instala o tm e depois pede que você conecte em um terminal seu. É lá que você digita a chave de API, então ela nunca aparece na conversa.

Set up the Time Momentum agent collector on this computer. Read and follow this guide: https://www.time-momentum.com/agents/collector.md

Guias para agentes em Markdown: coletor de agentes e linha de comando tm. As páginas de configuração no app mostram o mesmo prompt.

Capture suas sessões de IA.

O coletor de agentes registra tempo, modelo e uso de cada sessão do Claude Code, Codex e Cursor pelos hooks dessas ferramentas. Também no Free.

  1. Instale o tm

    Windows (PowerShell): irm https://app.time-momentum.com/install-cli.ps1 | iex. Depois abra um novo terminal.

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. Crie uma chave de API

    No app, em Datenquellen › Agent-Kollektor. Ela é exibida uma única vez.

  3. Conecte

    Pede a chave com entrada oculta, depois quais ferramentas capturar e se deve informar os limites da assinatura. Uma chave recusada não altera nada.

    tm collect init
  4. Verifique

    tm collect status

Só medições saem do seu computador: tempo, modelo, uso, pastas e commits. Nunca código-fonte ou nomes de arquivos; da conversa, no máximo um título de sessão, que você pode desativar.

Trabalhe com a linha de comando.

Uma chave com acesso de leitura cobre projetos e lançamentos de tempo. Todo o resto precisa de acesso de leitura e escrita, que faz parte do Pro.

  1. Instale o tm

    Pule esta etapa se o coletor já o instalou.

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. Faça login

    Crie a chave no app, em Datenquellen › CLI. O tm a pede com entrada oculta.

    tm auth login
  3. Verifique login e permissão

    tm whoami
  4. Claude Code: instale a skill

    tm skill --install
  5. Claude Code: linha de status

    Projeto, esforço e orçamento da sessão atual na parte inferior do Claude Code.

    tm statusline install

Ou sem instalar, por exemplo em um sandbox de agente: npx -y @time-momentum/cli@latest whoami

Plugin para Claude Code.

Traz a mesma skill e o comando /time-momentum:setup. Execute os dois comandos dentro do Claude Code.

  1. Adicione o marketplace

    /plugin marketplace add https://time-momentum.com/claude/marketplace.json
  2. Instale o plugin

    /plugin install time-momentum@time-momentum

Grupos de comandos.

Cada operação da API tem exatamente um comando. tm schema <group> --json lista flags, tipos e exemplos.

GrupoO que cobre
tm timersIniciar, pausar, parar e lançar tempo
tm customers, tm projects, tm ordersClientes, projetos com orçamento, pedidos e seu tipo de cobrança
tm invoices, tm paymentsMontar, emitir e exportar faturas como faturas eletrônicas, registrar e dividir pagamentos
tm statementsRelatórios de horas como anexo da fatura ou avulsos
tm ai-sessions, tm progressSessões de agentes com tempo de execução e uso, progresso do projeto
tm revenue, tm dashboard, tm exportRentabilidade, indicadores e dados brutos em CSV ou Excel
tm collectO coletor de agentes: conectar ferramentas, sincronizar, limites da assinatura
tm apiQualquer endpoint diretamente, autenticado como os demais comandos

API REST.

O tm é um cliente da API REST em https://app.time-momentum.com/api/v1. A lógica de negócio, como totais, impostos e números de fatura, fica no servidor, então scripts e agentes obtêm os mesmos resultados que o app web.

Uma chave de API (tmk_…) funciona diretamente como bearer token nas rotas de leitura, nos timers e na ingestão do coletor. Uma chave com acesso de escrita é trocada por um token válido por uma hora com POST /api/v1/auth/token. O tm faz isso por você e o renova automaticamente.

Chaves só são criadas no app web e podem ser revogadas lá a qualquer momento. O servidor recusa criar chaves ou excluir a conta por acesso de agente.

Todas as operações com parâmetros, schemas de requisição e resposta: especificação OpenAPI (OpenAPI 3.1, descrições em alemão).

Para agentes e scripts.

  • llms.txt: páginas e guias de configuração deste site em um único arquivo
  • agents/collector.md e agents/cli.md: guias de configuração para agentes de IA
  • tm --json: visão geral compacta de todos os grupos de comandos, convenções e códigos de saída
  • openapi.yaml: a API REST como OpenAPI 3.1
  • tm schema --json: o catálogo completo de comandos com flags, tipos e endpoints
  • tm skill: o guia de uso para agentes, de acordo com a versão instalada

Conecte suas ferramentas hoje.

  • 30 dias de Pro
  • Sem cartão de crédito
  • Depois, continue no Free

Perguntas frequentes

Preciso do Pro?

O coletor de agentes, os timers e a lista de projetos funcionam no Free. Acesso de escrita para a linha de comando e para o seu agente, faturas e as demais funções fazem parte do Pro, que toda conta nova testa por 30 dias.

Por que meu agente não pede a chave de API?

Para que a chave nunca vá parar na conversa. O agente instala o tm e pede que você execute tm collect init ou tm auth login em um terminal seu, onde a chave é digitada com entrada oculta.

Existe um servidor MCP?

Não. Seu agente já trabalha em um shell, e o tm carrega só a parte do catálogo de comandos de que ele precisa. Mais no guia MCP vs. CLI para agentes de IA.