Inicio / Artículos

Skipper: Una interfaz de control local para ejecutar múltiples sesiones de Claude Code al mismo tiempo.

Una interfaz de control gratuita de código abierto que sigue las sesiones de Claude Code, los subagentes y los bucles, te avisa en caso de solicitudes de permiso y te permite controlar a los agentes desde un navegador o teléfono.

Editor: REACTAPP.TOP6 min de lectura1433 palabras

Fuentes: Claude Code Dashboard: How I Track Multiple Claude Code Sessions, Subagents and Permission Prompts in One Place

El diseño de la terminal cambia en cuanto Claude Code deja de ser un hábito de una sola sesión. Cuatro o cinco sesiones funcionan simultáneamente: una está refacturando el backend, otra está escribiendo pruebas en un worktree de git, una /loop permanece inactiva hasta que finaliza el proceso CI, y otra ha generado tres subagentes en segundo plano y está esperando a que terminen. Parece productivo hasta que aparece un patrón: al regresar a la terminal después de veinte minutos, resulta que esa sesión ha estado allí todo el tiempo preguntando si se permite ejecutar una orden. Eso significa veinte minutos de inactividad de un agente de programación por IA porque necesitaba una tecla presionada mientras la atención estaba en otra ventana.

Ejecutar varios agentes en paralelo es poderoso, pero las terminales nunca fueron diseñadas para hacer un seguimiento de ellos. La pregunta importante es qué sesión necesita atención humana en este momento. Como no existía herramienta alguna que respondiera a esto, se creó Skipper.

Qué es Skipper

Skipper es el centro de control de misiones para Claude Code. Se trata de un panel de control gratuito, local y de código abierto que muestra en tiempo real todas las sesiones, subagentes, /loop y listas de tareas del equipo, y permite gestionarlos sin tener que pasar de un terminal a otro. Basta con una orden para iniciarlo:

npx github:bilol-makhmudov/skipper

Abra http://localhost:4317 y cada sesión aparecerá con un estado claro:

  • Necesita permiso: Claude está esperando aprobación para usar una herramienta.
  • Necesita su intervención: la turno ha finalizado y le toca enviar el próximo mensaje.
  • En funcionamiento: la sesión está en ejecución en este momento, con la herramienta en uso y el tiempo transcurrido desde el inicio del turno.
  • Dormida: un /loop está esperando su próxima activación, mostrando un contador regresivo y la razón por la que se pausó.

Las sesiones que requieren atención aparecen en la parte superior. El título de la pestaña indica cuántas sesiones están esperando, y el icono de favorito cambia a ámbar o rojo, de modo que incluso una pestaña fijada sigue enviando la señal correspondiente.

Monitoreo de subagentes, listas de tareas y bucles

Más allá de los estados de las sesiones, el panel muestra qué está haciendo cada agente:

  • Listas en tiempo real de tareas y proyectos, además de las listas de tareas de los equipos de agentes con sus responsables y obstáculos.
  • Subagentes en segundo plano con su nombre, modelo, rama del árbol de trabajo y la hora de su última acción.
  • Temporizadores /loop que muestran el próximo momento de activación y la razón de la pausa.
  • Flujos de trabajo, solicitudes de integración y artefactos, a solo un clic de distancia.
  • Un feed con todo lo que ocurrió mientras estuviste ausente, en todas las sesiones.
  • Uso de tokens por día, proyecto y modelo, incluyendo subagentes, con exportación en CSV.

Notificaciones para solicitudes de permisos

Esta es la función para la cual existe Skipper. Un único comando lo configura:

skipper hooks install

Añade dos ganchos oficiales de Claude Code, Notification y Stop, a la configuración. A partir de entonces, en cuanto una sesión solicita permiso, se emite un sonido y aparece una notificación en el escritorio que permanece hasta que se hace clic, mostrando el comando exacto que espera aprobación. Cuando una ronda finaliza, se escucha un sonido más suave.

Dicho gancho prácticamente no hace nada: simplemente agrega una línea a un archivo local de eventos y termina, por lo que no puede ralentizar ni interrumpir una sesión, lo cual es más importante que cualquier otra característica. Quienes no deseen tener una pestaña del navegador abierta pueden ejecutar skipper hooks native on para enviar notificaciones del sistema directamente.

Dirigir, no solo observar

  • Enviar un mensaje a una sesión. En el caso de una sesión abierta en una terminal, el texto se incluye en esa misma conversación. Las sesiones finalizadas se reinician en segundo plano, desde su directorio de trabajo original.
  • Editar tareas. Se pueden añadir, renombrar, completar o eliminar, aunque una tarea que sigue bloqueando otra no puede ser eliminada.
  • Notas privadas. Cada sesión puede contener notas, y se pueden enviar a Claude cuando sea el momento adecuado.
  • Modo solo lectura. La bandera --read-only desactiva cualquier escritura.
  • Claude Code en el teléfono, con un asistente de voz

    Una vez que el panel de control funcionó, el siguiente deseo fue poder usarlo lejos del escritorio, por ejemplo mientras se prepara té y se pregunta si una migración ya ha finalizado. Para ello, Skipper cuenta con una aplicación para iPhone desarrollada con Flutter. La conexión se realiza escaneando un código QR del panel de control, y la aplicación muestra las mismas sesiones, actividad y conversaciones. El asistente de voz es la parte más utilizada.

    Con un toque en el micrófono, la pregunta “¿Qué me necesita?” recibe una respuesta oral: qué sesión espera permiso, cuáles ya terminaron y cuáles siguen en ejecución. Se puede seguir preguntando sin tener que repetir el nombre de la sesión. Al decir “dile a la sesión de pago que se detenga después de esta prueba”, el asistente lee el mensaje de nuevo y espera; no se envía nada hasta que se responda afirmativamente. Entiende tanto inglés como uzbeko. En modo manos libres, sigue escuchando y deja de hablar en el momento en que el usuario habla.

    En realidad, el asistente es Claude Code en sí mismo, ejecutado sin interfaz gráfica con un pequeño conjunto de herramientas de solo lectura de Skipper expuestas a través de MCP, además de una herramienta para proponer mensajes. Ve todo lo que ve Skipper y no modifica nada sin confirmación.

    Cómo Claude Code almacena las sesiones en el disco

    La agradable sorpresa fue que Claude Code ya escribe todo lo que necesita un panel de control en ~/.claude:

    • ~/.claude/projects/*/<session>.jsonl almacena las transcripciones de las sesiones: consultas, respuestas, listas de tareas, subagentes, bucles y solicitudes de integración.
    • ~/.claude/sessions/*.json registra qué sesiones están activas y si cada una está ocupada o inactiva.
    • ~/.claude/tasks y ~/.claude/teams contienen listas de tareas y equipos de agentes.

    Las transcripciones se leen de forma incremental desde la última posición ya procesada, lo que mantiene receptiva incluso una historia muy extensa. Los cambios se envían al navegador a través de Server-Sent Events cuando se activan los monitores de archivos, por lo que no hay consulta periódica ni botón de actualización. El backend es un simple Node.js sin dependencias en tiempo de ejecución, y el frontend está formado por HTML, CSS y JavaScript habituales, sin pasos de compilación ni framework alguno.

    Enfocado en lo local y privado

    Las sesiones contienen código e instrucciones, por lo que una herramienta que las lea debe ser muy rigurosa en cuanto a la seguridad.

    • Sin tráfico saliente. La herramienta se entrega sin telemetría, CDN ni ninguna llamada externa. Solo las respuestas habladas opcionales por teléfono se envían a Internet, a través de las voces de Microsoft, mientras que el paso de voz a texto se procesa en la propia máquina mediante Whisper.
  • Por defecto, está vinculado a loopback. La validación del encabezado del host evita el rebinding DNS.
  • Un token controla el acceso al teléfono. En una red local, la salida de inicio incluye un enlace con un token aleatorio, y las solicitudes sin él no reciben respuesta alguna.
  • Las rutas de escritura están reforzadas. Cada una exige un encabezado personalizado, un payload JSON, una solicitud del mismo origen e IDs que pasen la validación. La CLI de claude recibe los mensajes como una lista de argumentos y nunca a través de una shell.
  • Política estricta de seguridad de contenido. Todo el contenido se muestra como texto y nunca como HTML sin procesar.
  • Instalación

    npm install -g github:bilol-makhmudov/skipper
    skipper hooks install      # chime and notify on permission prompts
    skipper service install    # run in the background, start at login
    

    Al agregar --demo --open se abre un recorrido con sesiones de ejemplo. Se requiere Node.js 20 o una versión más reciente, y se admiten macOS, Linux y Windows.

    Preguntas frecuentes

    • ¿Hay una vista para cada sesión? Skipper descubre las sesiones por sí mismo en ~/.claude, y una nueva sesión aparece tan pronto como se inicia.
    • ¿Están cubiertos los subagentes, los equipos de agentes y los worktrees? Sí. Los subagentes en segundo plano, las listas de tareas del equipo con responsables y las ramas de worktree se muestran todas.
    • ¿Hay una señal cuando se necesita permiso? Después de ejecutar skipper hooks install, las solicitudes de permiso, las preguntas y los turnos completados generan un sonido y una alerta en el escritorio.
  • ¿Puede un mensaje llegar a una terminal que ya está en ejecución? Se inserta en la conversación propia de esa terminal. Una sesión que ya se cerró se reanuda silenciosamente en segundo plano.
  • ¿Y qué pasa con el costo y el estado? La herramienta es gratuita y está bajo licencia MIT. Es un proyecto independiente y no tiene relación alguna con Anthropic.
  • Dentro de las futuras mejoras se incluyen conexiones telefónicas encriptadas, una versión para Android y más funcionalidades para gestionar sesiones desde cualquier lugar.