Repolode
kunchenguid

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. 1

    Autentica GitHub CLI

    gh auth login
  2. 2

    Clona el repositorio de firstmate

    git clone https://github.com/kunchenguid/firstmate
  3. 3

    Cambia al directorio clonado

    cd firstmate
  4. 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