모든 카드에서 병렬 에이전트를 실행하는 오픈소스 Kanban 데스크톱 앱

4 days ago 7

KanBots는 칸반 카드마다 Claude Code와 Codex를 병렬 실행하고, 진행 상황·결정·비용을 보드에 실시간 표시하는 데스크톱 앱임
각 실행은 kanbots/issue-N 브랜치의 별도 git worktree에서 격리되며, 폴더를 넣어 보드를 만들고 카드별 에이전트를 배정할 수 있음
Autopilot은 제품·엔지니어·리뷰어·테스터 같은 페르소나를 최대 병렬도 4로 순회하며 작업을 나누고 백로그를 갱신함
에이전트는 판단이 필요한 지점에서 멈춰 선택지를 제시하고, 사용자는 번호 선택·수정 재제출·/spec·/review·/split으로 이어갈 수 있음
데스크톱 앱은 무료 MIT 라이선스와 로컬 우선 방식을 채택하며, Cloud는 좌석당 월 $19로 팀 동기화·알림·대시보드를 제공함

KanBots의 기본 개념

KanBots는 Claude Code와 Codex 에이전트를 칸반 보드의 카드 단위로 병렬 실행하는 데스크톱 앱임
각 에이전트는 kanbots/issue-N 브랜치의 별도 git worktree에서 실행되며, 보드는 진행 상황·결정 요청·비용을 실시간으로 갱신함
폴더를 넣으면 보드가 생성되고, 여러 카드에 Claude Code 또는 Codex 에이전트를 배정할 수 있음
자동 실행 모드에서는 페르소나가 작업을 나누고 병렬로 실행하며 결과를 점검함
데스크톱 앱은 무료, MIT 라이선스, 기부 기반이며 로컬 우선 방식으로 동작함

제품 구성과 과금

데스크톱 OSS
- Desktop은 로컬 우선, 계정 없음, 원격 측정 없음, 무료 영구 제공, MIT 라이선스 방식임
- macOS, Linux, Windows를 지원하고 모든 기능을 포함함
- 주요 기능에는 병렬 에이전트 실행, 자동 실행, 결정 프롬프트, 내장·사용자 정의 페르소나, 실시간 비용 분석, 레시피 라이브러리, kanbots-mcp-server, Sentry 가져오기, GitHub Issues 모드, 브랜치 미리보기, PR 초안 생성, Claude Code·Codex 지원, 사전 푸시 훅이 포함됨
팀용 Cloud
- Cloud는 호스팅형 다중 사용자 제품이며, 에이전트는 사용자 하드웨어에서 로컬로 실행됨
- 가격은 좌석당 월 $19이며, 연간 청구 시 $190임
- OSS 기능에 더해 보드 실시간 존재 표시, 팀원 할당 알림, 기기 간 동기화, Slack 알림, 조직 전체 비용 집계, 실시간 공동 카드 편집, 조직별 에이전트 활동 대시보드, Managed GitHub App을 제공함
- Enterprise 기능에는 감사 로그, SSO / SCIM, REST API와 PAT, 아웃바운드 웹훅이 포함됨
- Cloud 전용 기능은 다른 사람이나 다른 기기가 있어야 의미 있는 기능으로 제한되며, 한 명이 한 기계에서 쓰는 기능은 OSS에 포함됨

지원 도구와 연동

Claude Code와 Codex CLI를 지원함
GitHub Issues와 PR 작업을 지원함
Sentry 오류 가져오기를 지원함
Cursor와 Claude Desktop은 MCP 클라이언트로 연동 가능함
로컬 저장소는 SQLite를 사용함
데스크톱 셸은 Electron 기반으로 제공됨

핵심 기능

병렬 카드 실행
- 여러 카드에서 에이전트를 동시에 실행할 수 있으며, 각 실행은 자체 git worktree와 kanbots/issue-N 브랜치에서 진행됨
- 보드는 실행 진행, 에이전트의 결정 요청, 비용 누적을 실시간으로 갱신함
자동 실행과 페르소나
- 제품, 엔지니어, 리뷰어, 테스터 같은 페르소나를 연결하고 병렬도는 최대 4까지 설정할 수 있음
- 오케스트레이터가 페르소나를 라운드로빈으로 순회하고, 상위 이슈를 하위 작업으로 나누며, 에이전트가 발견한 작업으로 백로그를 갱신함
- 페르소나가 다른 페르소나를 생성할 수 있음
결정 중심 실행
- 에이전트는 필요한 결정을 만나면 멈추고 선택지를 표시함
- 사용자는 번호 선택, 수정 후 재제출, /spec, /review, /split 같은 슬래시 명령으로 실행을 이어갈 수 있음
- 작업 트리를 조용히 바꾸는 대신 검토 가능한 결정 흐름을 남김
Claude Code와 Codex 통합
- Claude Code 또는 Codex를 같은 보드, 같은 worktree, 같은 결정 UI에서 사용할 수 있음
- KanBots는 단일 AgentCliAdapter 뒤에서 두 스트림 형식을 처리함
- 기존 claude /login 또는 OPENAI_API_KEY를 사용할 수 있음
로컬 우선 저장
- 모든 데이터는 저장소 옆 .kanbots/ 안에 위치함
- SQLite 데이터베이스, 설정, worktree가 로컬에 저장됨
- 클라우드 계정, 원격 측정, HTTP 서버가 없고 코드가 기계를 떠나지 않음
비용 분석과 예산 제한
- 실행별, 카드별, 프로젝트별 비용 집계를 제공함
- 에이전트 작업 중 비용 미터가 누적됨
- 실행별·세션별 한도를 설정할 수 있고, 예산에 도달하면 실행이 중단됨
GitHub 워크플로
- 개인 PAT로 실제 GitHub 이슈를 다룰 수 있음
- worktree를 커밋으로 승격하거나, 한 번의 클릭으로 초안 PR을 열 수 있음
- 사전 푸시 훅을 통해 에이전트가 스스로 게시하지 못하게 함
MCP 서버
- kanbots-mcp-server가 Model Context Protocol을 통해 보드를 노출함
- Cursor, Claude Desktop 또는 MCP를 이해하는 도구가 보드를 다룰 수 있음
- 보드가 다른 에이전트가 사용할 수 있는 도구가 됨

앱 내부 워크플로

Autopilot
- 하나 이상의 페르소나를 선택하고 병렬도를 설정한 뒤 자동 실행을 시작함
- 최대 4개의 병렬 슬롯이 페르소나 목록을 라운드로빈으로 순회함
- 각 슬롯은 다음 페르소나를 원자적으로 가져오고, 에이전트는 진행 중 상위 이슈를 하위 작업으로 나눔
- 완료 또는 세션 예산 도달 시 중단됨
- 예시 화면에는 Claude Opus 4.7, medium effort, 병렬도 2, Product Manager와 Senior Engineer 페르소나가 선택된 상태가 표시됨
Decisions
- 실행 스레드는 모든 tool_use와 tool_result를 실시간으로 스트리밍함
- 에이전트가 판단이 필요한 지점에서 실행을 멈추고 번호가 붙은 선택지를 제시함
- 답장 입력창은 /spec, /review, /split 같은 명령을 받음
- 비밀번호 재설정 토큰 구현 예시에서는 단일 사용 JWT, DB 저장 불투명 토큰, 매직 링크, 먼저 트레이드오프 설명 같은 선택지가 표시됨
- 실행 화면에는 모델, 경과 시간, 토큰 수, 비용, 상태, 우선순위, 폴더, worktree, 브랜치, 기준 브랜치, 작성자가 표시됨
Personas
- 페르소나는 이름이 붙은 시스템 프롬프트 조각임
- 기본 페르소나는 앱에 포함되며, 사용자가 새 페르소나를 작성해 저장하고 재사용할 수 있음
- 사용자 정의 페르소나는 해당 기계에 로컬로 저장됨
- 기본 예시로 Product Manager, Senior Engineer, UX Designer, Growth Lead, Reliability Engineer가 제공됨
Providers
- Claude Code와 Codex를 하나의 AgentCliAdapter 뒤에서 사용할 수 있음
- 기존 claude /login 또는 codex login을 재사용하며, 추가 계정이나 추가 키 관리가 필요 없음
- 실행마다 공급자를 전환할 수 있음
- Codex CLI는 codex가 PATH에 있어야 하며, 이슈 초안 작성과 Sentry 분석은 여전히 Claude에서 실행됨
- Codex 로그인은 브라우저에서 auth.openai.com을 열거나 환경 변수 OPENAI_API_KEY를 사용할 수 있음
Tasks
- 새 작업은 버그 수정, 기능, 리팩터링, 리뷰, 스파이크 템플릿을 제공함
- 시작 방식은 spec-first, 생성 후 즉시 실행, 나중에 큐에 넣기 중 선택함
- 제목은 브랜치와 PR 제목으로 사용됨
- spec-first는 /spec을 실행해 인수 조건을 다듬고 승인 대기 상태로 둠
- 새 작업은 fresh worktree를 만들고, main 기준으로 .kanbots/worktrees/issue-N 아래 브랜치를 생성함
Chat
- 워크스페이스에 대해 질문할 수 있는 범용 에이전트가 제공됨
- 에이전트는 저장소, 테스트, git 상태를 알고 질문에 답함
- rate limiting이 없는 API 라우트를 찾고, /api/login과 /api/signup에 rateLimit({ windowMs: 60_000, max: 10 })을 추가한 뒤 테스트를 작성해 통과시키는 예시가 제시됨

Autopilot의 동작 방식

Autopilot은 이슈와 예산을 받아 백로그를 스스로 갱신하는 모드임
오케스트레이터가 페르소나 목록을 라운드로빈으로 순회하고, 최대 4개 슬롯을 병렬로 실행함
상위 이슈를 하위 작업으로 나누고, 작업이 수렴하거나 비용 한도에 도달할 때까지 순환함
예시에는 병렬도 4, 모델 opus 4.7, 세션 예산 $25.00 중 $4.27 사용, 14번째 사이클 상태가 표시됨
페르소나 목록 선택
- 기본 페르소나를 사용하거나 직접 시스템 프롬프트를 정의해 저장하고 재사용할 수 있음
- 사용자 정의 페르소나는 기계를 떠나지 않음
병렬도 설정
- 병렬도는 1부터 4까지 설정 가능함
- 각 슬롯은 라운드로빈 카운터를 통해 다음 페르소나를 원자적으로 가져감
- 네 에이전트가 네 관점과 네 worktree에서 동시에 실행될 수 있음
작업 분할
- 에이전트가 작업을 발견하면 새 카드를 보드에 생성함
- 이후 사이클이 새 카드를 가져가며 백로그가 오케스트레이터 아래에서 늘어나고 줄어듦
예산 또는 완료 시 중단
- 세션별 비용 예산이 전체 지출을 제한함
- 중지 버튼은 부모 실행과 모든 자식 실행을 종료함
- 진행 중인 실행은 현재 반복을 깨끗하게 마침