Cómo dejar de manejar agentes de IA en la terminal y organizar un equipo con Firstmate
Escena familiar: abres cinco pestañas de terminal, cada una ejecutando su propio agente de codificación. Uno corrige una prueba inestable, otro reescribe componentes para modo oscuro, un tercero ejecuta una auditoría de dependencias. Diez minutos después, el caos se instala. ¿Cuál agente terminó? ¿Dónde fallaron las pruebas? ¿Qué rama acaba de fusionarse?
El proyecto firstmate ofrece un enfoque diferente. En lugar de controlar manualmente cada agente, te comunicas con un asistente principal — el primer oficial. Les entregas tareas y ellos las distribuyen a "marineros" autónomos en entornos aislados.
¿Qué es un distro de agentes
Los creadores de firstmate describen su proyecto no como otra utilidad CLI o framework, sino como un distro de agentes. Básicamente, es un conjunto portable de instrucciones en formato AGENTS.md, habilidades listas para usar, scripts y reglas de comportamiento.
Clonas el repositorio en tu máquina, ejecutas tu herramienta CLI familiar dentro de él (como Claude Code o Grok), y dinámicamente recoge la lógica para gestionar todo el equipo. No es necesario instalar aplicaciones adicionales ni dependencias pesadas en tu sistema.
Cómo funciona la arquitectura
Toda la idea se construye sobre la separación de responsabilidades y el aislamiento de los espacios de trabajo.
Le das comandos al primer oficial a través de un solo chat. Por ejemplo: "revisar el proyecto xyz, corregir la prueba de autorización que falla, y agregar modo oscuro".
El primer oficial clona el repositorio en la carpeta projects/ y crea las tareas.
Para cada tarea, se lanza una ventana de terminal separada (tmux, zellij, cmux, u Orca) y se crea un árbol de trabajo git aislado usando la herramienta treehouse.
Los marineros autónomos trabajan en paralelo, sin interferir entre sí ni romper la base de código principal.
Después de completar las tareas, el primer oficial recoge los resultados y entrega una solicitud de extracción o informe de investigación listo.
Un detalle interesante: el proceso de monitoreo no consume tokens de red neuronal. Un script bash en segundo plano supervisa el estado de la sesión. Duerme hasta que ocurre un evento en una de las ventanas o un marinero necesita una decisión humana. Solo entonces el observador despierta al primer oficial y le pasa un breve resumen.
Modos y comandos
El proyecto tiene habilidades integradas que se invocan directamente desde el chat:
/afkcambia el sistema a modo ausente. El proceso en segundo plano maneja mensajes técnicos menores por su cuenta, mientras que las preguntas genuinamente importantes se recopilan en un resumen y se preparan para tu regreso./bearingsgenera un breve resumen de todas las tareas en ejecución y solicitudes de extracción activas./ahoyte ayuda a ponerte al día rápidamente mostrando la línea de tiempo de eventos y las preguntas que requieren tu aprobación./stowprocesa el contexto acumulado, guarda el conocimiento importante en disco y archiva datos obsoletos, ahorrando presupuesto de tokens.
Más allá del desarrollo estándar con creación de PRs, firstmate tiene un modo de investigación (scout). Si necesitas auditar seguridad o explorar el módulo de otra persona en lugar de cambiar código, el marinero compilará un informe detallado en un archivo Markdown sin modificar el repositorio.
Agentes compatibles y lanzamiento
El repositorio está bien preparado para trabajar con herramientas CLI populares. Claude Code, Grok y Pi son los recomendados oficialmente como primer oficial principal. Codex y OpenCode también han sido probados.
Tmux se usa como backend de terminal predeterminado, pero también se admiten zellij, cmux y Orca.
El inicio rápido se ve así:
gh auth login
git clone https://github.com/kunchenguid/firstmate
cd firstmate
claude
Después del inicio, Claude Code recogerá las instrucciones de AGENTS.md, y solo necesitarás saludarlo con ahoy!.
¿Para quién es este proyecto
Si solo usas asistentes de IA ocasionalmente para refactorizaciones menores de una sola función, firstmate puede parecer excesivo. Pero cuando trabajas activamente en paralelo en múltiples tareas, el proyecto ahorra mucho tiempo. El aislamiento mediante git worktree evita que los cambios se sobrescriban, y un solo chat con el primer oficial elimina la necesidad de cambiar constantemente entre una docena de ventanas.
Proyectos relacionados