butchr

재작성된 소프트웨어 팩토리. 다음을 수행하는 단일 로컬 데몬:

1. Jira 감시 — API 토큰을 소유한 계정에 할당된 티켓과 그들이 링크된 항목들.

2. 활성 티켓당 에이전트 실행 — 티켓이 In Progress 또는 In Review 상태일 때, herdr 에이전트를 가동합니다 (@brooswit/herdr-sdk를 통해).

3. 해당 에이전트에 업데이트 푸시 — MCP (@brooswit/thatch)를 통해: 에이전트는 작업 중인 이슈를 식별하여 데몬에 연결하고, 데몬은 티켓/댓글/링크 변경 사항을 올바른 에이전트로 전달합니다.

4. 라이브 뷰 표시 — 활성 에이전트를 나열하는 웹앱; 하나를 클릭하면 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에 보존되어 있습니다.