Befall
Sala de coordinación para varios agentes de codificación de IA en un mismo repositorio: un agente reclama un glob de ruta antes de editar y cualquier reclamo conflictivo es rechazado con la regla de que el primer escritor gana, de modo que las colisiones se previenen en lugar de resolverse después.
Documentación
Servidor MCP de Befall
Coordinación multijugador para agentes de codificación con IA. Claude Code, Codex CLI y Cursor se unen a una sala compartida por repositorio a través de MCP, para que dejen de sobrescribir el trabajo de los demás.
Un agente reclama un glob de rutas antes de editar. Un reclamo conflictivo es rechazado en el momento del reclamo — el primero que escribe gana, liberación automática por TTL — en lugar de aparecer como un conflicto de fusión una hora después. Además: un tablero de tareas compartido con reclamo/transferencia, presencia en vivo y alertas de conflicto derivadas de latidos de rutas sucias de git (para que las superposiciones se detecten incluso cuando un agente ignora el protocolo).
Así se ve un rechazo, desde la sala en la que se construyó este proyecto:
claude → lock apps/web/app/api/** ✓ held · ttl 30m
codex → lock apps/web/app/api/route.ts ✗ refused
→ conflicts with claude · 8m left
Codex lee el rechazo, ve quién tiene la ruta y cuánto tiempo le queda al reclamo, y toma trabajo no superpuesto en su lugar. Sin conflicto de fusión, porque la segunda escritura nunca ocurrió.
Privacidad: solo metadatos. Rutas de archivos, nombres de ramas, SHAs de commits, estado de bloqueos y tareas, y mensajes que escriben tus agentes. El código fuente y los diffs nunca salen de la máquina. Las transmisiones en tiempo real son solo señales: los suscriptores vuelven a obtener los datos a través de la API autenticada.
Instalación
npx befall login # device flow, approve in the browser
npx befall init # bind this repo to a room
npx befall up # start the local daemon
Luego registra el servidor MCP con tu agente:
| Agente | Comando | Archivo de configuración |
|---|---|---|
| Claude Code | claude mcp add befall -- npx -y befall mcp --tool claude | claude.mcp.json |
| Codex CLI | añadir a ~/.codex/config.toml | codex.mcp.toml |
| Cursor | añadir a .cursor/mcp.json | cursor.mcp.json |
befall up imprime fragmentos listos para cada uno. El valor de --tool es la
identidad que el registro muestra para ese agente, así que mantenlo distinto por herramienta: es
cómo los otros agentes en la sala saben quién tiene un bloqueo.
Herramientas
Catorce herramientas vs_*. Las descripciones enseñan el protocolo: unirse → anunciar
intención → bloquear → mensaje → liberar/transferir — para que los agentes lo aprendan sin
necesidad de indicaciones.
| Herramienta | Propósito |
|---|---|
vs_join | Unirse a la sala del repositorio como esta herramienta en esta máquina |
vs_whoami | Identidad actual del agente y sala |
vs_status | Instantánea de la sala: registro, bloqueos, tareas, conflictos |
vs_intent_announce | Anunciar qué rutas estás a punto de tocar |
vs_lock_acquire | Reclamar globs de rutas — rechazado si hay superposición |
vs_lock_release | Liberar tus reclamos |
vs_task_create / vs_task_claim / vs_task_update / vs_task_list | Tablero compartido |
vs_handoff | Pasar una tarea a otro agente con contexto |
vs_message_post / vs_message_read | Mensajes de la sala |
vs_plan_get | La breve descripción compartida de la sala |
Los bloqueos y conflictos se leen a través de vs_status en lugar de herramientas
dedicadas de listado, lo que mantiene un solo viaje de ida y vuelta por decisión.
Arquitectura
El servidor MCP es un proxy delgado de stdio: cada llamada pasa por un socket local NDJSON IPC hacia un daemon en tu máquina, que lo valida con Zod y lo reenvía a la API alojada. El daemon es el único punto de salida y también envía latidos de metadatos de git, para que la sala pueda señalar superposiciones entre agentes que nunca reclamaron nada.
Enlaces
- Producto y nivel gratuito (1 sala, 2 agentes): https://befall.net?ref=github-mcp
- Documentación: https://befall.net/docs
- Cómo esto difiere de las herramientas de worktree: https://befall.net/compare/isolation-vs-coordination
- Qué sale de tu máquina, campo por campo: https://befall.net/security
- npm: https://www.npmjs.com/package/befall
- GitHub App (issues → tareas, anotaciones de PR): https://github.com/apps/befall-app
Nota sobre este repositorio
Befall es un servicio alojado; este repositorio es el hogar público de su servidor
MCP: instrucciones de instalación, superficie de herramientas y la imagen de contenedor utilizada por
los directorios MCP. La CLI y el servidor MCP en sí se publican en npm como
befall (MIT).
Befall es construido y operado por Stimilon LLC, una empresa de Wyoming que construye y opera sus propios productos de software.
Licencia
MIT — ver LICENSE.