butchr

La fábrica de software, reescrita. Un único demonio local que:

1. Vigila tu Jira — los tickets asignados a la cuenta propietaria del token de API, y los elementos a los que enlazan.

2. Ejecuta un agente por ticket activo — cuando un ticket está En Progreso o En Revisión, lanza un agente herdr (a través de @brooswit/herdr-sdk).

3. Envía actualizaciones a esos agentes — mediante MCP (@brooswit/thatch): los agentes se conectan al demonio identificando en qué issue trabajan, y el demonio canaliza los cambios de tickets/comentarios/enlaces al correcto.

4. Muestra una vista en vivo — una aplicación web que lista los agentes activos; haz clic en uno y butchr abre una ventana de terminal ejecutando herdr agent attach en él, para que entres directamente en el shell de ese agente. Sin extensión de navegador, sin terminal embebido — los terminales son terminales herdr reales.

La detección de cambios es el watch de @brooswit/sundry sobre un feed JQL de Jira. Las solicitudes de bloqueo de los agentes se gestionan mediante la detección blocked de herdr + send_keys (herdr es el dueño del terminal; butchr lee y responde).

Arquitectura

one Elysia process
├── /mcp          agents connect here (thatch), identifying via x-issue header
├── /agents,/health   read-only live view
└── loops (landing incrementally)
    ├── jira-watch    sundry.watch over `assignee = currentUser() AND updated >= cursor`
    ├── reconcile     desired (In Progress/In Review) ↔ herdr agents: spawn / stop
    └── notify        ticket/comment/link change → thatch channel → the agent on that issue

src/: config · atlassian (cliente Jira) · daemon (la aplicación + notificación) · web (vista en vivo). Más bucles se incorporan como módulos propios.

Related MCP server: Jira MCP Server

Instalación y ejecución

En cada máquina:

npm i -g @brooswit/butchr     # or pin a version
cp .env.example .env          # fill in ATLASSIAN_SITE / EMAIL / TOKEN_FILE
butchr                        # reads .env / the environment

Desde el código fuente (desarrollo):

bun run start

Desarrollo

bun run check    # generate + typecheck + tests + coverage ≥90%   (what CI runs)

Cada cambio en src/ necesita una entrada en CHANGELOG.md y un incremento de versión (el CI lo exige).

El predecesor (300 versiones de historia) se conserva en brooswit/butchr-legacy.