Repolode
furkankly

furkankly/zoetrope

Un visor para terminal y navegador que representa sesiones de Claude Code y Codex como un grafo de flujo en vivo con agentes y sus llamadas a herramientas.

Estrellas
1,062
Forks
73
Issues abiertos
13
Último commit
hace 6 días

¿Qué es?

zoetrope lee los archivos de transcripción que Claude Code y Codex generan para cada sesión y la representa como un grafo: el agente principal, los subagentes que crea y las herramientas que ejecuta cada uno. El grafo se actualiza a medida que avanza la sesión. Es posible reproducir una sesión finalizada a una velocidad configurable, siguiendo las marcas de tiempo de la propia sesión, o ver cómo crece una sesión en curso.

La herramienta es de solo lectura y funciona completamente en local, sin ningún cliente de red en su árbol de dependencias. Además del binario nativo `zoe`, el mismo motor se ejecuta en el navegador compilado a WebAssembly, donde se puede abrir una transcripción desde el disco o arrastrarla a la página. El comando sin interfaz `zoe inspect` imprime el árbol de la sesión sin iniciar la interfaz.

Funciones clave

  • 01Representa cada agente, sus subagentes y los grupos de flujo de trabajo como nodos con su estado y el número de llamadas a herramientas.
  • 02Muestra las llamadas a herramientas como etiquetas debajo de cada agente e indica si se completaron correctamente o fallaron.
  • 03Reproduce sesiones finalizadas o permite seguir las que están en curso, con una línea de tiempo que se puede recorrer.
  • 04Al retroceder, restaura la sesión exactamente tal como estaba en ese momento.
  • 05Haz clic en un agente para ver el prompt que lo generó, su modelo y sus llamadas a herramientas con sus tiempos.
  • 06Se ejecuta en la terminal o en el navegador, y cuenta con un modo de inspección sin interfaz.

Casos de uso

  • Seguir una sesión prolongada de Claude Code o Codex para ver qué subagentes están activos.
  • Revisar una ejecución finalizada de un agente para entender cómo se delegaron las tareas y qué herramientas se usaron.
  • Depurar un flujo de trabajo de agentes recorriendo su historial en cualquier momento.
  • Inspeccionar una sesión en una máquina sin TTY mediante el comando sin interfaz.

Inicio rápido

  1. 1

    Instálalo con Homebrew

    brew install furkankly/tap/zoetrope
  2. 2

    O instálalo con Cargo

    cargo install zoetrope
  3. 3

    Ejecútalo para seguir la sesión en directo del proyecto actual

    zoe

Antes de usarlo

  • Depende de formatos de transcripción no documentados de Claude Code y Codex, que pueden cambiar sin previo aviso.
  • Es un visor de solo lectura; no controla ni ejecuta sesiones de agentes.

Temas

Preguntas frecuentes

¿Qué es zoetrope?
Un visor para terminal y navegador que representa sesiones de Claude Code y Codex como un grafo de flujo en vivo con agentes y sus llamadas a herramientas. zoetrope lee los archivos de transcripción que Claude Code y Codex generan para cada sesión y la representa como un grafo: el agente principal, los subagentes que crea y las herramientas que ejecuta cada uno. El grafo se actualiza a medida que avanza la sesión. Es posible reproducir una sesión finalizada a una velocidad configurable, siguiendo las marcas de tiempo de la propia sesión, o ver cómo crece una sesión en curso.
¿zoetrope es gratuito? ¿Qué licencia tiene?
zoetrope es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿zoetrope sigue mantenido?
Mantenimiento activo. El último commit de zoetrope fue el 14 oct 2026.
¿Para qué puedo usar zoetrope?
Seguir una sesión prolongada de Claude Code o Codex para ver qué subagentes están activos. Revisar una ejecución finalizada de un agente para entender cómo se delegaron las tareas y qué herramientas se usaron. Depurar un flujo de trabajo de agentes recorriendo su historial en cualquier momento. Inspeccionar una sesión en una máquina sin TTY mediante el comando sin interfaz.
¿Cómo se instala zoetrope?
Instálalo con Homebrew: brew install furkankly/tap/zoetrope O instálalo con Cargo: cargo install zoetrope Ejecútalo para seguir la sesión en directo del proyecto actual: zoe
¿Dónde consigo zoetrope?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/furkankly/zoetrope

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados