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:

AgenteComandoArchivo de configuración
Claude Codeclaude mcp add befall -- npx -y befall mcp --tool claudeclaude.mcp.json
Codex CLIañadir a ~/.codex/config.tomlcodex.mcp.toml
Cursorañadir a .cursor/mcp.jsoncursor.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.

HerramientaPropósito
vs_joinUnirse a la sala del repositorio como esta herramienta en esta máquina
vs_whoamiIdentidad actual del agente y sala
vs_statusInstantánea de la sala: registro, bloqueos, tareas, conflictos
vs_intent_announceAnunciar qué rutas estás a punto de tocar
vs_lock_acquireReclamar globs de rutas — rechazado si hay superposición
vs_lock_releaseLiberar tus reclamos
vs_task_create / vs_task_claim / vs_task_update / vs_task_listTablero compartido
vs_handoffPasar una tarea a otro agente con contexto
vs_message_post / vs_message_readMensajes de la sala
vs_plan_getLa 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

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.