Time Machine: uma linha do tempo do Claude Code de cada chamada de ferramenta

O Time Machine é um mod da comunidade feito por YeonwooSung (my-claude-code-mods) que dá a cada sessão uma linha do tempo do Claude Code. Quando um agente edita vários arquivos e você acaba num estado errado, um git diff só diz o que mudou. O Time Machine registra qual chamada de ferramenta rodou, em que ordem e como os arquivos ficaram depois, para que você possa voltar a qualquer passo.

Tudo passa por um único comando, /tm. /tm desenha a linha do tempo, /tm show <n> mostra um passo, /tm diff <a> [b] compara os arquivos em dois passos e /tm why lista as edições que mais provavelmente quebraram uma execução de testes com falha. /tm restore <n> e /tm branch <n> devolvem os arquivos a um passo, /tm compare compara dois branches ou sessões, /tm rerun <n> repete um passo e /tm sessions lista as sessões registradas. /tm-pane abre um painel com a linha do tempo ao vivo, e a barra de status mostra algo como tm ② · 1 snaps · 79ms.

Ele restaura arquivos e repete ferramentas; não reproduz as respostas do modelo e a conversa não é retrocedida.

A gravação inicia o Claude Code com o mod carregado no pequeno projeto de demonstração, com o armazenamento apontando para uma pasta temporária. Pedimos ao Claude que crie NOTES.md com uma linha sobre o projeto. O Claude lê o README.md e escreve o arquivo. Enquanto isso, a barra de status sobe de tm ⓪ para tm ② e mostra 1 snaps. Depois digitamos /tm. A linha do tempo lista o snapshot base (5 arquivos), ① Read README.md e ② Write NOTES.md com seu próprio snapshot, em que A NOTES.md marca o arquivo adicionado.

Use qualquer um dos métodos do bloco de instalação; eles instalam direto do marketplace do próprio autor. O mod passa a funcionar na próxima sessão, e o /tm é registrado quando a sessão começa.

A cada tool.call o mod registra um passo. Depois de cada ferramenta que modifica arquivos (edição, escrita, toda chamada de Bash por padrão, ferramentas desconhecidas e de MCP), ele faz commit da árvore de trabalho em um repositório bare "sombra" guardado no próprio armazenamento, com índice próprio, de modo que seu .git nunca é lido nem escrito. Se, antes de uma ferramenta rodar, a árvore mudou desde o último snapshot, por exemplo porque você editou um arquivo no IDE, isso é registrado como um passo external em vez de ser atribuído ao agente. A proteção dos comandos que alteram arquivos, de hooks/register.tsx:

// Origins a person typed: the only ones allowed to change files or run commands through /tm.
const TYPED = new Set(['composer', 'bridge', 'sdk'])

const sub = changesFiles(args)
const kind = e.origin?.kind ?? 'unknown'
if (sub !== undefined && !TYPED.has(kind)) return { text: `time-machine: ${sub} changes files or runs commands and only runs when you type it (this came from ${kind})` }

/tm why é uma inferência, não uma prova: ele pega a última execução bem-sucedida do mesmo comando de teste antes de uma que falhou e pontua cada arquivo alterado entre as duas, mais alto se a saída da falha menciona o caminho. A saída dos testes é analisada para pytest, jest e vitest, go, cargo e node:test; qualquer outra saída usa só o código de saída.

As configurações do plugin têm quatro opções:

• storeDir: onde ficam os snapshots e as linhas do tempo, uma pasta por projeto. Precisa ser um caminho absoluto ou começar com ~/ e ficar fora do projeto; caso contrário, os snapshots são desativados. O padrão é ~/.claude/time-machine.
• retentionDays: sessões mais antigas são apagadas, verificado no máximo uma vez por dia. O padrão é 14; 0 mantém tudo.
• recordModelOutput: desativada por padrão. Ativada, guarda o texto da resposta do modelo e os primeiros 200 caracteres de cada prompt; desativada, apenas tamanhos e hashes.
• skipSearchBash: desativada por padrão. Ativada, não é feito snapshot após comandos de Bash classificados como busca (rg, grep, ls, cat).

Lemos todos os arquivos que o plugin carrega: plugin.json, hooks/hooks.json, hooks/register.tsx, hooks/git.ts e tudo em hooks/core/, além do README e dos testes. Não há package.json, script de instalação, binário nem código empacotado. Uma busca por fetch, http, child_process, eval, import() dinâmico, WebSocket e caracteres Unicode de largura zero ou bidirecionais não encontrou nada. Achados relevantes:

• Executa processos por meio de $.process.run: git (contra o repositório sombra), além de mkdir, rm -rf, cp, find -delete e sh. rm -rf e find -delete ficam limitados a caminhos dentro da pasta de armazenamento (verificações isInside em register.tsx e git.ts). /tm rerun --isolated --yes executa o comando de Bash registrado com sh -lc numa cópia do snapshot. Não é um sandbox e não passa pelo diálogo de permissão; só roda quando você digita e recusa comandos que citem o caminho absoluto do projeto.
• Grava arquivos na pasta de armazenamento, ~/.claude/time-machine por padrão. Nada é gravado em settings.json, arquivos de shell, LaunchAgents nem hooks do git. /tm restore --yes reescreve os arquivos rastreados do seu projeto, mas só quando você digita, depois de salvar um snapshot anterior, e recusa se arquivos ignorados fossem sobrescritos.
• Registra o seu trabalho: os snapshots guardam o conteúdo completo dos arquivos não ignorados, inclusive segredos que você mantenha no projeto. Entradas e resultados de ferramentas são mascarados na medida do possível, mas o conteúdo dos arquivos nos snapshots não. Revise a pasta antes de compartilhá-la.
• Injeta texto na conversa uma única vez: depois de uma restauração, acrescenta uma nota dizendo que os arquivos foram restaurados e que resultados anteriores de ferramentas estão desatualizados. Fora isso, não reescreve prompts nem resultados.
• Envolve cada chamada de ferramenta (hook de controle tool.call com .catch). Repassa a resposta sem alterações, inclusive negações, e erros de registro nunca bloqueiam a ferramenta. Chamadas modificadoras em paralelo esperam a verificação de mudanças externas.
• Sem rede, daemons ou telemetria. A limpeza roda separada após a inicialização, mas termina com a sessão. A única variável de ambiente lida é HOME.
• Requisito externo: o git precisa estar instalado. Os snapshots são desativados se a raiz da sessão for sua pasta pessoal ou /.
• Licença: Apache-2.0 (arquivo LICENSE na raiz do repositório), que permite redistribuição.

O claude plugin validate não relatou erros nem avisos. Os testes do autor passaram no Claude Code 2.1.303: 103 passaram, 0 falharam.

Testado com o Claude Code 2.1.303 no macOS (validate, os testes do autor e a gravação da demo). O autor indica o Claude Code 2.1.287 ou posterior. Se algo parecer errado:

• A barra de status mostra snapshots off: execute /tm; o motivo aparece no topo. Causas comuns são a raiz da sessão ser sua pasta pessoal, um storeDir relativo ou dentro do projeto, falta de git ou um snapshot base que levou mais de 5 segundos.
• Em um repositório grande, cada ferramenta modificadora paga o tempo do snapshot; a média aparece na barra de status.
• Um arquivo de log que muda o tempo todo dentro do projeto gera um passo external antes de cada ferramenta modificadora.
• Arquivos ignorados (saídas de build, node_modules, .env) nunca são salvos nem restaurados.
• O painel e a barra de status aparecem no terminal; no painel de chat do VS Code só os comandos funcionam.