butchr

Die Software-Fabrik, neu geschrieben. Ein einzelner lokaler Daemon, der:

1. Dein Jira beobachtet — die Tickets, die dem Konto zugewiesen sind, dem der API-Token gehört, sowie die Elemente, auf die sie verlinken.

2. Einen Agenten pro aktivem Ticket ausführt — wenn ein Ticket In Progress oder In Review ist, startet er einen herdr-Agenten (über @brooswit/herdr-sdk).

3. Updates an diese Agenten pusht — über MCP (@brooswit/thatch): Agenten verbinden sich mit dem Daemon und identifizieren, an welchem Issue sie arbeiten, und der Daemon leitet Ticket-/Kommentar-/Link-Änderungen an den richtigen weiter.

4. Eine Live-Ansicht zeigt — eine Web-App, die die aktiven Agenten auflistet; klicke auf einen und butchr öffnet ein Terminalfenster, das herdr agent attach darauf ausführt, sodass du direkt in die Shell dieses Agenten eintauchst. Keine Browser-Erweiterung, kein eingebettetes Terminal — Terminals sind echte herdr-Terminals.

Die Erkennung von Änderungen erfolgt über watch von @brooswit/sundry über einen Jira-JQL-Feed. Blockierende Agent-Prompts werden über herdrs eigene blocked-Erkennung + send_keys behandelt (herdr besitzt das Terminal; butchr liest und antwortet).

Architektur

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 (Jira-Client) · daemon (die App + notify) · web (Live-Ansicht). Weitere Schleifen landen als eigene Module.

Related MCP server: Jira MCP Server

Installation & Ausführung

Auf jeder Maschine:

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

Aus dem Quellcode (Entwicklung):

bun run start

Entwicklung

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

Jede src/-Änderung benötigt einen CHANGELOG.md-Eintrag und eine Versionserhöhung (CI erzwingt das).

Vorgänger (300 Releases Geschichte) aufbewahrt unter brooswit/butchr-legacy.