Repolode
furkankly

furkankly/zoetrope

Visualizador para terminal e navegador que mostra sessões do Claude Code e Codex como um grafo dinâmico de agentes e chamadas de ferramentas.

Estrelas
1,062
Forks
73
Issues abertas
13
Último commit
há 6 dias

O que é?

zoetrope lê os arquivos de transcrição que Claude Code e Codex gravam para cada sessão e a representa como um grafo: o agente principal, os subagentes que ele inicia e as ferramentas que cada um executa. O grafo é atualizado conforme a sessão avança. É possível reproduzir uma sessão concluída em uma velocidade configurável, seguindo os timestamps da própria sessão, ou acompanhar uma sessão em andamento enquanto ela cresce.

A ferramenta é somente leitura e funciona inteiramente de forma local, sem cliente de rede na árvore de dependências. Além do binário nativo `zoe`, o mesmo mecanismo roda no navegador, compilado para WebAssembly, onde é possível abrir uma transcrição do disco ou arrastá-la para a página. O comando headless `zoe inspect` exibe a árvore da sessão sem iniciar a interface.

Recursos principais

  • 01Mostra cada agente, seus subagentes e grupos de fluxo de trabalho como nós com status e contagem de ferramentas.
  • 02Exibe as chamadas de ferramentas como chips abaixo do agente, indicando se foram concluídas com sucesso ou falharam.
  • 03Reproduz sessões concluídas ou acompanha sessões em andamento, com uma linha do tempo navegável.
  • 04Ao voltar na linha do tempo, restaura a sessão exatamente como estava naquele momento.
  • 05Clique em um agente para ver o prompt que o iniciou, o modelo usado e as chamadas de ferramentas com seus tempos de execução.
  • 06Roda no terminal ou no navegador, com um modo de inspeção headless.

Casos de uso

  • Acompanhar uma sessão longa do Claude Code ou Codex para ver quais subagentes estão ativos.
  • Analisar uma execução concluída de um agente para entender como as tarefas foram delegadas e quais ferramentas foram usadas.
  • Depurar um fluxo de trabalho de agente percorrendo o histórico em qualquer momento.
  • Inspecionar uma sessão em uma máquina sem TTY usando o comando headless.

Início rápido

  1. 1

    Instale com Homebrew

    brew install furkankly/tap/zoetrope
  2. 2

    Ou instale com Cargo

    cargo install zoetrope
  3. 3

    Execute para acompanhar a sessão ao vivo do projeto atual

    zoe

Antes de usar

  • Depende de formatos de transcrição não documentados do Claude Code e do Codex, que podem mudar sem aviso prévio.
  • É um visualizador somente de leitura; não controla nem executa sessões de agentes.

Tópicos

Perguntas frequentes

O que é zoetrope?
Visualizador para terminal e navegador que mostra sessões do Claude Code e Codex como um grafo dinâmico de agentes e chamadas de ferramentas. zoetrope lê os arquivos de transcrição que Claude Code e Codex gravam para cada sessão e a representa como um grafo: o agente principal, os subagentes que ele inicia e as ferramentas que cada um executa. O grafo é atualizado conforme a sessão avança. É possível reproduzir uma sessão concluída em uma velocidade configurável, seguindo os timestamps da própria sessão, ou acompanhar uma sessão em andamento enquanto ela cresce.
zoetrope é gratuito? Qual é a licença?
zoetrope é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
zoetrope ainda é mantido?
Manutenção ativa. O último commit de zoetrope foi em 14 de out. de 2026.
Para que posso usar zoetrope?
Acompanhar uma sessão longa do Claude Code ou Codex para ver quais subagentes estão ativos. Analisar uma execução concluída de um agente para entender como as tarefas foram delegadas e quais ferramentas foram usadas. Depurar um fluxo de trabalho de agente percorrendo o histórico em qualquer momento. Inspecionar uma sessão em uma máquina sem TTY usando o comando headless.
Como instalar zoetrope?
Instale com Homebrew: brew install furkankly/tap/zoetrope Ou instale com Cargo: cargo install zoetrope Execute para acompanhar a sessão ao vivo do projeto atual: zoe
Onde consigo zoetrope?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/furkankly/zoetrope

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados