Ajuda: apps de IA e tempo de programação

Conecte o Hourcrumb a apps de IA para perguntar sobre seu tempo ou registrá-lo com suas próprias palavras, e deixe o tempo que você passa em ferramentas de programação virar blocos sugeridos sozinho. As duas coisas precisam do Hourcrumb Plus e de uma conta Hourcrumb.

Seu computador

Pergunte a um app de IA sobre seu tempo

Adicione o Hourcrumb ao app uma vez. Na primeira vez que ele usar o Hourcrumb, vai abrir o Hourcrumb no seu navegador: entre e escolha Permitir. Não tem chave para copiar.

Claude

No app do Claude no seu computador, ou em claude.ai: Configurações → Conectores → Adicionar conector personalizado. Dê o nome Hourcrumb, cole este endereço e escolha Conectar. Depois funciona também no app do Claude no seu celular.

https://api.hourcrumb.com/mcp

Claude Code

Só para o Claude Code no terminal (ele precisa do comando claude). Rode isto, depois digite /mcp no Claude Code e escolha hourcrumb para entrar.

claude mcp add --transport http hourcrumb https://api.hourcrumb.com/mcp

Codex

Rode estes comandos no terminal. O segundo abre o Hourcrumb para você entrar.

codex mcp add hourcrumb --url https://api.hourcrumb.com/mcp
codex mcp login hourcrumb

Cursor

No computador com o Cursor, use o botão ou adicione este endereço em Configurações do Cursor → MCP. Entre quando o Cursor pedir.

Adicionar ao Cursor

https://api.hourcrumb.com/mcp

Antigravity

No painel Agent, abra … → MCP Servers → Manage MCP Servers → View raw config, adicione estas linhas e salve. Entre quando for pedido.

{
  "mcpServers": {
    "hourcrumb": {
      "serverUrl": "https://api.hourcrumb.com/mcp"
    }
  }
}

Depois experimente: "Quanto trabalhei em cada projeto esta semana?" ou "Registre 2 horas de Escrita hoje de manhã."

Registre o tempo de programação sozinho

Enquanto você trabalha com uma ferramenta de programação com IA, o Hourcrumb anota em qual pasta você está, no máximo uma vez por minuto, e transforma isso em blocos sugeridos com nomes como "Claude Code · meu-app". Você os confirma como qualquer outra sugestão.

Claude Code · Codex

1. Instale o Node.js

Baixe o instalador LTS em https://nodejs.org e abra. Se você usa Homebrew, pode rodar isto no lugar:

brew install node

Para conferir, rode isto no terminal: deve aparecer v18 ou mais novo.

node -v

2. Abra um terminal

Aperte Cmd+Space, digite Terminal e aperte Return.

3. Rode estes comandos

npx hourcrumb login
npx hourcrumb setup claude
npx hourcrumb setup codex

O primeiro abre o Hourcrumb no seu navegador: entre e escolha Permitir. Os outros adicionam o Hourcrumb ao Claude Code e ao Codex, e guardam um backup de cada arquivo que alteram. Pule a linha da ferramenta que você não usa.

4. Reinicie a ferramenta

Feche o Claude Code ou o Codex e abra de novo: o registro começa na próxima sessão. No app do Claude para desktop, abra uma nova sessão de Code.

Antigravity · VS Code · Cursor

Abra Extensões, procure Hourcrumb e escolha Instalar. Depois abra a paleta de comandos (Cmd+Shift+P), rode "Hourcrumb: Sign in" e escolha Permitir no seu navegador. A barra de status mostra Hourcrumb enquanto estiver registrando.

Confira se funciona

Trabalhe por um minuto e abra Hoje no Hourcrumb: um bloco sugerido com o nome da ferramenta e da pasta aparece depois da próxima sincronização. Para ver se a ferramenta de terminal está conectada e configurada, rode:

npx hourcrumb status

Se parar de funcionar

Se você desconectou o app em Configurações → Apps de IA, ou não usou por 90 dias, entre de novo: npx hourcrumb login (nos editores, "Hourcrumb: Sign in"). Os hooks só rodam em sessões abertas depois da configuração.

Se o npx parar com um erro do npm como ENOENT ou EPERM, o cache do npm está corrompido. Rode isto e tente de novo:

npm cache verify

Remover

Rode isto e desconecte o app em Configurações → Apps de IA. A configuração deixou uma cópia de cada arquivo alterado ao lado dele (terminando em .hourcrumb-backup), caso você queira o antigo de volta.

npx hourcrumb logout

O que é enviado

Só o nome da ferramenta e o nome da pasta (não o caminho), no máximo uma vez por minuto. Prompts, código, nomes de arquivos e respostas ficam no seu computador. Mais na política de privacidade.