Un desarrollador aloja a los agentes de Claude Code y Codex en el notch del MacBook por un 0,5% de CPU

Tres o cuatro sesiones paralelas de Claude Code y Codex convierten rápidamente la jornada laboral en un ir y venir entre ventanas: un agente ha terminado, otro espera confirmación y un tercero se ha colgado. El autor de un análisis en Habr lo resolvió con una pequeña aplicación para macOS. La app muestra el estado de todos los agentes en el notch del MacBook y lo ilumina cuando alguno necesita a una persona. Cada sesión aparece dibujada como un muñeco en una oficina pixelada. Según el autor, el brillo cuesta aproximadamente un 0,5% del procesador.

El problema: muchos agentes y ningún panel de control

Ejecutar agentes de programación en paralelo ya es una práctica habitual. Uno refactoriza un módulo, otro escribe tests y un tercero investiga un bug. Las herramientas para ello siguen pensadas para una sola ventana de terminal y una sola persona que la mira. Si un agente se detiene a la espera del permiso para ejecutar un comando, se queda parado hasta que usted se da cuenta. En tareas largas, esas pausas suman horas.

La elección del notch tiene su lógica. Es la única zona de la pantalla que las ventanas no tapan y siempre está a la vista. La aplicación ocupa un espacio vacío y no compite por el sitio con el editor.

Cómo funciona

Para Claude Code, el autor usa hooks. Es un mecanismo que ejecuta sus comandos en eventos del ciclo de vida de la sesión, por ejemplo al detenerse o al solicitar atención. La aplicación recibe la señal en el momento del evento y no sondea los procesos en bucle.

Con Codex el esquema es distinto. El autor lee los registros de sesión que la herramienta escribe en disco y prescinde de una API. La solución es pragmática, pero con una salvedad: el formato de los registros no es un contrato público. Una actualización de Codex puede cambiar la estructura de los archivos, y habrá que arreglar el parser.

La parte visual se compone de dos capas:

• la oficina pixelada se dibuja con SpriteKit, y cada sesión corresponde a un muñeco;
• el brillo del notch está hecho con Core Animation, en lugar de redibujar la escena de forma constante.

El segundo punto explica la cifra del 0,5% de CPU. Una animación gestionada por el sistema de composición es más barata que un renderizado fotograma a fotograma. Para una aplicación que permanece abierta todo el día, esto es fundamental. Una utilidad indicadora no debe quitarles recursos a los agentes ni al IDE.

Parámetros clave

• Plataforma: macOS, zona del notch del MacBook.
• Claude Code: los estados llegan mediante hooks.
• Codex: lectura de registros, sin API.
• Visualización: oficina pixelada con SpriteKit.
• Señal de espera: brillo con Core Animation, alrededor del 0,5% de CPU.
• Estadísticas: el autor afirma que las recopila sin un solo contador dentro de la aplicación. Los detalles los da en el artículo completo.

Qué se puede aprovechar

Si lanza varios agentes a la vez, no hace falta empezar por el notch. La versión mínima cabe en una tarde: un hook de Claude Code en el evento de parada escribe el estado en un archivo o envía una notificación del sistema. Eso por sí solo ahorra la mitad de las comprobaciones de ventanas.

Después conviene decidir en qué confiar. Los hooks son mejores que el parseo de registros, porque son un punto de extensión documentado. Los registros resultan útiles cuando la herramienta no tiene un evento claro, pero hay que reservar tiempo para el mantenimiento. Si lee los archivos del CLI de otro, mantenga una validación del formato y muestre en la interfaz el error de análisis, en lugar de dar por colgado al agente en silencio.

Otra lección se refiere al consumo de recursos. Cualquier indicador en segundo plano que acompañe a agentes que ya cargan el procesador y la memoria debe moverse en fracciones de porcentaje. Es mejor delegar la animación en el sistema de composición que dibujar la escena de nuevo en cada fotograma.

La oficina pixelada puede verse como un adorno, pero tiene un sentido práctico. Un muñeco sentado en su mesa, otro junto a la cafetera y otro con la mano levantada se leen más rápido que una tabla de estados. Para quienes desarrollan herramientas de agentes, este proyecto señala lo que les falta a los propios productos: un flujo estable de eventos sobre el estado de la sesión, que no haya que extraer de los logs.