butchr

ソフトウェアファクトリー、書き直し。単一のローカルデーモンで、以下のことを行います：

1. Jiraを監視 — APIトークンを所有するアカウントに割り当てられたチケットと、それらがリンクする項目。

2. アクティブなチケットごとにエージェントを実行 — チケットがIn ProgressまたはIn Reviewのとき、herdrエージェント（@brooswit/herdr-sdk経由）を起動します。

3. それらのエージェントに更新をプッシュ — MCP（@brooswit/thatch）経由：エージェントは自分が取り組んでいる課題を識別してデーモンに接続し、デーモンはチケット/コメント/リンクの変更を適切なエージェントに送ります。

4. ライブビューを表示 — アクティブなエージェントを一覧表示するWebアプリ。クリックするとbutchrはherdr agent attachを実行するターミナルウィンドウを開き、そのエージェントのシェルに直接入ります。ブラウザ拡張機能も埋め込みターミナルもありません — ターミナルは本物のherdrターミナルです。

変更検出は@brooswit/sundryのwatchをJira JQLフィードに対して行います。ブロッキングエージェントのプロンプトはherdr自身のblocked検出とsend_keysで処理されます（herdrがターミナルを所有し、butchrが読み取って回答します）。

アーキテクチャ

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クライアント） · daemon（アプリ+通知） · web（ライブビュー）。その他のループは独自のモジュールとして追加されます。

Related MCP server: Jira MCP Server

インストールと実行

各マシンで：

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

ソースから（開発）：

bun run start

開発

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

src/の変更にはCHANGELOG.mdへの追記とバージョンアップが必要です（CIが強制します）。

前身（300リリースの履歴）はbrooswit/butchr-legacyに保存されています。