<p align="center">
<img src="https://raw.githubusercontent.com/jjyr/canban/HEAD/crates/ui/assets/app-icon.svg" width="84" alt="Canban icon" />
</p>
Canban
원본 에이전트 CLI를 대체하지 않으면서 칸반 카드를 자동화된 코딩 워크플로우로 전환합니다.
Canban = Kanban + Workflow + Herdr
칸반 카드에서 기능을 논의하고, 사용자 정의 가능한 워크플로우를 통해 코딩 에이전트를 전송하며, 격리된 Git 작업 트리(worktree)로부터 변경 사항을 병합하는 모든 과정을 한 곳에 유지합니다.
<p align="center">
<strong class="English">English</strong> · <a href="README.zh-CN.md">简体中文</a>
</p>
<p align="center">
<a href="https://canban.dev"><strong class="Website (canban.dev)">웹사이트</strong></a> ·
<a href="#philosophy">철학(Philosophy)</a> ·
<a href="#highlights">주요 기능(Highlights)</a> ·
<a href="#installation">설치(Installation)</a> ·
<a href="#related-software-and-acknowledgements">관련 소프트웨어(Related Software)</a> ·
<a href="#license">라이선스(License)</a>
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/jjyr/canban/HEAD/docs/assets/readme-board.png" width="860" alt="Canban Board in Monokai theme" />
</p>
철학(Philosophy)
- 칸반은 인간의 맥락을 정리합니다 — 사양(specs),
#Card 참조, 스크린샷, @Agent 토론, 구조화된 보고서 및 검토 게이트가 각 카드에 함께 유지됩니다.
- Herdr는 최소한의 간섭으로 네이티브 에이전트 CLI를 구동합니다 — Claude Code, Codex, Antigravity (
agy), Cursor CLI 또는 사용자 정의 CLI를 네이티브 TUI(Text User Interface), 권한, MCPs, 스킬 및 세션 재개 기능을 온전히 유지하면서 영구적인 PTY 내부에서 직접 실행할 수 있습니다.
- 대부분의 작업은 칸반에 남아 있고 워크플로우를 통해 전송됩니다 — 워크플로우가 Git 작업 트리를 격리하고 에이전트를 전송하며 병합을 자동으로 대기열화하는 동안 보드(Board)에서 범위를 조정하고 diff를 검토할 수 있습니다.
주요 기능(Highlights)
칸반: 인간을 위한
보드에서 라이브 @developer, @reviewer, @merger 상태 캡슐과 함께 커스터마이징 가능한 단계(Backlog → Develop → Review)를 거쳐 카드를 이동시킬 수 있습니다. 각 카드는 Markdown 사양, 붙여넣은 스크린샷, #Card / #tag 링크, Cmd+O (Linux에서는 Ctrl+Shift+O) 빠른 열기 기능, 그리고 외부 PR을 위한 승인 게이트가 적용된 GitHub Issue/PR 동기화를 결합합니다.
GitHub Actions 스타일 워크플로우(Workflows)
격리된 카드별 Git worktree 내부에서 열 전환, @agent 실행, 사용자 지정 스크립트, 조건, 수동 승인, 그리고 직렬 FIFO 큐 병합 (Queue Merge) (자동 @merger 충돌 해결을 포함한 deliver)을 자동화할 수 있습니다. 이는 Workflow Studio에서 시각적으로 작성하거나, YAML 형식으로 작성하거나, 또는 에이전트와 함께 편집(Edit with agent) 기능을 통해 수행됩니다.
<p align="center">
<img src="https://raw.githubusercontent.com/jjyr/canban/HEAD/docs/assets/readme-workflow.png" width="840" alt="Monokai 테마의 Kanban 시각적 워크플로우 스튜디오" />
</p>
Herdr 터미널(Terminal)
모든 카드에서 Cmd+J (Linux에서는 Ctrl+Shift+J)를 누르면 나란히 분할된 터미널이 열리거나 전용 터미널(Terminals) 작업 공간을 열 수 있습니다. 이 기능은 Rust로 구축되었으며, longbridge/nsh (macOS의 네이티브 AppKit/Metal, Linux의 GTK4)와 로컬 또는 원격 SSH/Tailscale을 통한 canband + herdr-core 위에서 libghostty-vt를 사용합니다. 에이전트 PTY는 앱 재시작 및 17가지 내장 다크 테마에 걸친 업그레이드에도 살아남습니다.
<p align="center">
<img src="https://raw.githubusercontent.com/jjyr/canban/HEAD/docs/assets/readme-card-terminal.png" width="840" alt="Monokai 테마의 Kanban 카드 상세 및 Herdr 터미널 분할 보기" />
</p>
설치(Installation)
사전 요구 사항 (Prerequisites):
- macOS: macOS 13.0 이상 (Apple Silicon /
arm64)
- Linux 데스크톱: GTK4 및 GStreamer 런타임 라이브러리 (
libgtk-4-1 / gtk4 + gstreamer)가 설치된 x86_64 또는 aarch64 (arm64)
- 공통:
git, 최소 하나의 네이티브 에이전트 CLI (claude, codex, agy, cursor-agent 등), 그리고 Herdr Core (hc) (누락된 경우, Kanban은 첫 실행 시 원클릭 hc 설정을 안내합니다).
curl -fsSL https://canban.dev/install.sh | bash
- macOS:
/Applications/Canban.app을 설치하거나 라이브 업그레이드하며, Gatekeeper 격리 해제 및 로컬 애드혹 코드 서명을 자동으로 처리합니다.
- Linux Desktop:
~/.local/opt/canban을 설치하거나 라이브 업그레이드하고, ~/.local/bin/{canban,canban-ui}에 링크하며, XDG .desktop 런처와 아이콘(~/.local/share/applications 및 icons/hicolor)을 등록합니다.
- 헤드리스 리눅스 호스트 (canband): 데스크톱 세션이 없는 원격 Linux 서버에서,
--headless를 전달하여 GTK4 의존성 없이 독립적인 ~/.local/bin/canban을 설치합니다 (curl -fsSL https://canban.dev/install.sh | bash -s -- --headless). 활성화된 herdr-core 세션과 systemd --user canban.service 유닛은 업그레이드를 거쳐 유지됩니다.
소스에서 빌드하기 (Build from Source)
mise와 플랫폼별 빌드 종속성을 설치한 다음, mise run install-app을 실행합니다:
- macOS:
brew install librsvg
- Ubuntu / Debian:
sudo apt install pkg-config libgtk-4-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev librsvg2-bin zstd
- Arch Linux:
sudo pacman -S pkgconf gtk4 gstreamer gst-plugins-base librsvg zstd
- Fedora:
sudo dnf install pkgconf-pkg-config gtk4-devel gstreamer1-devel gstreamer1-plugins-base-devel librsvg2-tools zstd
git clone https://github.com/jjyr/canban.git && cd canban && mise run install-app
Kanban은 다음 오픈 소스 프로젝트 및 자산을 기반으로 구축되었습니다 (전체 출처 표기 및 라이선스는 [THIRD_PARTY_NOTICES.md]에 보존되어 있습니다):
라이선스
저작권 2026 JJy [email protected].
Apache License, Version 2.0에 따라 라이선스가 부여되었습니다 (LICENSE).