swarm

Swarm es un plano de control local-first diseñado para desarrolladores que ejecutan múltiples agentes de codificación de IA simultáneamente. Se ejecuta como un único daemon en tu máquina, leyendo los hooks, transcripciones y registros de sesión que agentes como Claude Code, Codex CLI, Gemini CLI, Grok, Aider y opencode ya producen, sin requerir ningún cambio de instrumentación en tus repositorios. Todo el estado vive en ~/.swarm/ y el panel se vincula a 127.0.0.1, de modo que nada sale de tu máquina, no se necesita cuenta y funciona sin conexión. El valor central es la observabilidad y la coordinación. La vista Fleet muestra cada sesión en cada proyecto en tiempo real: qué agente se está ejecutando, en qué rama, qué está haciendo ahora mismo, modelo, tokens de salida, tamaño de contexto, coste y antigüedad. Una sesión que comienza a repetir un comando que falla recibe una insignia Stuck y una notificación de escritorio. La vista Session transmite en vivo el razonamiento y las llamadas de herramientas de un agente, con coste por turno, tasa de acierto de caché, proporción de pensamiento e histograma de herramientas. Replay recorre las llamadas de herramientas una a una con entrada y salida completas, y una sesión finalizada puede reanudarse desde donde murió. El Board sirve como libro mayor de coordinación para un proyecto. Realiza un seguimiento de tareas desde un backlog en markdown, GitHub Issues o Linear, con compuertas de aprobación/fallo y acciones Run/Dispatch. Las reclamaciones de tareas se mantienen en worktrees de git aislados, cada uno con rama, deriva, estado sucio/sin empujar y la sesión dentro de él. Los recursos en tiempo de ejecución — puertos, servidores de desarrollo, bases de datos — se mantienen como singulares con nombre. Los incidentes registran cada comando que las reglas preguntaron o denegaron, con una acción Codify que convierte uno en una regla .swarm.toml y una lección CLAUDE.md. Las reglas son salvaguardas sobre los comandos Bash que ejecuta una sesión de Claude Code: shared_tree, destructive_git, pattern_kill, protected_ports, no_foreign_worktree y claim_required_to_write. Cada una se configura como ask, deny u off por repositorio en .swarm.toml. Una denegación se devuelve a Claude Code como una denegación de permiso real. Los puertos retenidos como recursos se protegen automáticamente. Son salvaguardas contra accidentes, no una sandbox. Swarm también puede generar agentes: swarm run --task X reclama una tarea y lanza claude -p en su worktree, orientable por stdin y detenible por pid. swarm dispatch --ready entrega cada tarea reclamable a su propio run, N a la vez. Los perfiles de ejecución (full, no-edits, read-only) limitan lo que un agente generado puede hacer. Las compuertas declaradas en .swarm.toml se ejecutan en el worktree de la tarea — la salida 0 pasa, la cola de la salida es la evidencia. Cada sesión que se pausa deja un auto-handoff con archivos editados, último comando de verificación y última solicitud; la siguiente sesión en ese worktree lo recibe inyectado al inicio. Un agente que se encuentra con una decisión que solo un humano puede tomar llama a swarm_ask; la pregunta aparece en la página de la sesión con opciones como botones, Fleet muestra una insignia Asking, se dispara una notificación de escritorio y la respuesta llega al agente por sí sola. Los flujos de trabajo declarativos en .swarm.toml avanzan automáticamente: los pasos run generan un agente, los pasos gate deben pasar para continuar, y pr empuja la rama y abre la pull request. La mensajería agente a agente mediante swarm_send llega a otra sesión por id, a quien tenga una tarea o a la sesión líder. La vista PRs proporciona una única cola de fusiones en GitHub y GitLab, leída a través de tu CLI gh o glab ya autenticada. No se almacenan tokens. El Timeline muestra carriles de sesión por proyecto, coloreados por agente, de 3 a 72 horas. Spend y Stats desglosan el coste por proyecto, modelo, agente y tarea, con una tabla de presupuesto de contexto que clasifica las sesiones por cuánto contexto releen. Los presupuestos por repositorio aplican topes diarios o semanales que advierten, preguntan o detienen. Outcomes rastrea si el trabajo sobrevivió: las sesiones se unen a una rama, la rama a su PR, el PR a fusionado o revertido, puntuado por modelo y por agente con tasa de fusión, mediana del tiempo hasta fusionar y dólares por fusión. Un gráfico bipartito en vivo muestra las sesiones en ejecución frente a los archivos que tocan; un archivo que dos sesiones mantienen con al menos un escritor se vuelve rojo — un conflicto de fusión que aún puedes prevenir. Swarm está disponible como CLI (bunx @ra3orblade/swarm setup), aplicación de escritorio (macOS firmada y notarizada, Windows, Linux .deb/.rpm) y servidor MCP que permite a los agentes coordinarse entre sí. El daemon de equipo (swarm-teamd) es un segundo servicio autoalojado para configuraciones de múltiples máquinas, que reenvía eventos de auditoría, resúmenes de gastos y reclamaciones — nunca texto de transcripciones a menos que una máquina lo opte. El paquete de equipo está disponible en fuente bajo FSL-1.1-ALv2, convirtiéndose a Apache-2.0 dos años después de cada publicación; todo lo demás es Apache-2.0.