Orquestador de programación con IA multimodelo que asigna tareas especializadas definidas en Markdown a las CLI de Claude, Codex, Gemini, Kimi y Grok, en worktrees de Git aislados.
kunchenguid/firstmate
Una distribución de agentes para coordinar un equipo de agentes de programación: hablas con un agente principal que asigna tareas en paralelo en worktrees de Git aislados y sesiones tipo tmux.
- Estrellas
- 8,643
- Forks
- 2,718
- Issues abiertos
- 2,608
- Último commit
- ayer
¿Qué es?
firstmate es un directorio portátil de instrucciones, skills y scripts auxiliares que convierte un agente de programación de terminal de propósito general en coordinador de un equipo de agentes. No hay que instalar ninguna aplicación: clonas el repositorio, inicias en él un entorno compatible, como Claude Code, Grok, Pi, Codex u OpenCode, y esa sesión se convierte en el agente principal. Describes el trabajo por chat y el agente principal inicia agentes autónomos, cada uno en su propia sesión visible y en un worktree de Git limpio; luego los supervisa hasta que preparan un PR, una fusión local aprobada o un informe de investigación.
El proyecto está pensado para situaciones en las que ejecutar varios agentes de programación a la vez se convierte en una tarea de supervisión manual: cambiar entre terminales, copiar contexto entre repositorios y perder de vista qué tarea falló. La supervisión se basa en eventos: un observador solo activa al agente principal cuando un agente necesita que se tome una decisión. Cada proyecto se puede configurar para entregar los cambios mediante un PR, un PR directo o una fusión solo local. Además, se pueden usar agentes secundarios persistentes opcionales desde entornos aislados, ya sea en la máquina local o en un host accesible por SSH.
El repositorio es compatible con macOS y Linux, y con varios backends de sesiones, incluido tmux como opción predeterminada de referencia, además de herdr, Zellij y otros marcados como experimentales.
Funciones clave
- 01Habla con un único agente principal que asigna y supervisa agentes en paralelo.
- 02Cada tarea se ejecuta en su propio worktree de Git desechable, para que el trabajo paralelo en un mismo repositorio no genere conflictos.
- 03Los agentes se ejecutan en ventanas visibles de tmux o en otros backends de sesiones compatibles, a los que puedes acceder o que puedes observar.
- 04Los modos de cada proyecto determinan si los cambios se entregan mediante un PR, un PR directo o una fusión solo local.
- 05Los agentes secundarios persistentes opcionales pueden ejecutarse desde entornos aislados, localmente o en hosts accesibles por SSH.
- 06Un observador basado en eventos activa al agente principal solo cuando hace falta tomar una decisión.
Casos de uso
- Ejecutar a la vez varias correcciones de errores o tareas de funcionalidades en distintos repositorios.
- Delegar investigaciones o auditorías de bases de código a agentes y recibir un informe por escrito.
- Coordinar una flota de agentes de programación desde una sola sesión de chat, sin tener que alternar entre terminales.
- Repartir cargas de trabajo grandes entre agentes secundarios persistentes en distintas máquinas.
Inicio rápido
- 1
Autentica GitHub CLI
gh auth login - 2
Clona el repositorio de firstmate
git clone https://github.com/kunchenguid/firstmate - 3
Cambia al directorio clonado
cd firstmate - 4
Inicia un entorno compatible, como Claude Code; a partir de ahí, AGENTS.md se encarga
claude
Antes de usarlo
- No es una aplicación independiente: se ejecuta dentro de un entorno de agente de programación compatible, como Claude Code, Grok o Pi.
- Requiere GitHub CLI autenticado y tmux u otro backend de sesión compatible.
- Algunos backends y funciones, como Zellij, cmux y T3 Code, están marcados como experimentales.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es firstmate?
- Una distribución de agentes para coordinar un equipo de agentes de programación: hablas con un agente principal que asigna tareas en paralelo en worktrees de Git aislados y sesiones tipo tmux. firstmate es un directorio portátil de instrucciones, skills y scripts auxiliares que convierte un agente de programación de terminal de propósito general en coordinador de un equipo de agentes. No hay que instalar ninguna aplicación: clonas el repositorio, inicias en él un entorno compatible, como Claude Code, Grok, Pi, Codex u OpenCode, y esa sesión se convierte en el agente principal. Describes el trabajo por chat y el agente principal inicia agentes autónomos, cada uno en su propia sesión visible y en un worktree de Git limpio; luego los supervisa hasta que preparan un PR, una fusión local aprobada o un informe de investigación.
- ¿firstmate es gratuito? ¿Qué licencia tiene?
- firstmate es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿firstmate sigue mantenido?
- Mantenimiento activo. El último commit de firstmate fue el 6 nov 2026.
- ¿Para qué puedo usar firstmate?
- Ejecutar a la vez varias correcciones de errores o tareas de funcionalidades en distintos repositorios. Delegar investigaciones o auditorías de bases de código a agentes y recibir un informe por escrito. Coordinar una flota de agentes de programación desde una sola sesión de chat, sin tener que alternar entre terminales. Repartir cargas de trabajo grandes entre agentes secundarios persistentes en distintas máquinas.
- ¿Cómo se instala firstmate?
- Autentica GitHub CLI: gh auth login Clona el repositorio de firstmate: git clone https://github.com/kunchenguid/firstmate Cambia al directorio clonado: cd firstmate Inicia un entorno compatible, como Claude Code; a partir de ahí, AGENTS.md se encarga: claude
- ¿Dónde consigo firstmate?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/kunchenguid/firstmate
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Una cuadrícula de terminales en el navegador para ejecutar en paralelo varias sesiones de Claude Code y otros agentes de programación, con colores que indican cuál necesita tu atención.
Un tablero Kanban de terminal que ejecuta varios agentes de programación en paralelo, con un git worktree y una ventana de tmux por tarea.
Gestor de espacios de trabajo en Go que coordina varios agentes de programación con IA, como Claude Code, Copilot y Codex, y conserva su estado de trabajo en hooks respaldados por Git.
Un espacio de trabajo web donde equipos y agentes de programación con IA comparten tableros espaciales en tiempo real, con cada agente en su propia rama de git aislada.
Una aplicación de terminal (CLI/TUI) para ejecutar y administrar varios agentes de programación con IA, como Claude Code, Codex y Aider, en espacios de trabajo de Git separados.