Turn Kanban cards into automated coding workflows, without replacing your native agent CLIs.
Canban = Kanban + Workflow + Herdr
Discuss features on Kanban cards, dispatch coding agents through customizable workflows, and merge changes from isolated Git worktrees, all while keeping task context and progress in one place.
English · 简体中文
Website (canban.dev) · Philosophy · Highlights · Installation · Related Software · License
- Kanban organizes human context — specs,
#Cardreferences, screenshots,@Agentdiscussions, structured reports, and review gates stay together on each Card. - Herdr drives native Agent CLIs with minimal interference — run Claude Code, Codex, Antigravity (
agy), Cursor CLI, or custom CLIs directly inside persistent PTYs with native TUIs, permissions, MCPs, skills, and session resume intact. - Most work stays on Kanban and dispatches via workflows — shape scope and review diffs on the Board while workflows isolate Git worktrees, dispatch agents, and queue merges automatically.
Move Cards across customizable stages (Backlog → Develop → Review) with live @developer, @reviewer, and @merger status capsules right on the Board. Each Card combines Markdown specs, pasted screenshots, #Card / #tag links, Cmd+O (Ctrl+Shift+O on Linux) Quick Open, and GitHub Issue/PR sync with approval gates for external PRs.
Automate column transitions, @agent runs, custom scripts, conditions, human approvals, and serialized FIFO Queue Merge (deliver with automatic @merger conflict resolution) inside isolated per-Card Git worktrees — authored visually in Workflow Studio, in YAML, or via Edit with agent.
Press Cmd+J (Ctrl+Shift+J on Linux) on any Card for a side-by-side terminal split or open the dedicated Terminals workspace. Built in Rust with longbridge/nsh (native AppKit/Metal on macOS, GTK4 on Linux) and libghostty-vt over local or remote SSH/Tailscale canband + herdr-core, running agent PTYs survive app restarts and upgrades across 17 built-in dark themes.
Prerequisites:
- macOS: macOS 13.0+ (Apple Silicon /
arm64) - Linux Desktop:
x86_64oraarch64(arm64) with GTK4 and GStreamer runtime libraries (libgtk-4-1/gtk4+gstreamer) - Common:
git, at least one native Agent CLI (claude,codex,agy,cursor-agent, etc.), and Herdr Core (hc) (Canban guides one-clickhcsetup on first launch if missing).
curl -fsSL https://canban.dev/install.sh | bash- macOS: Installs or live-upgrades
/Applications/Canban.app, automatically handling Gatekeeper quarantine removal and local ad-hoc code signing. - Linux Desktop: Installs or live-upgrades
~/.local/opt/canban, links~/.local/bin/{canban,canban-ui}, and registers the XDG.desktoplauncher and icons (~/.local/share/applications&icons/hicolor). - Headless Linux Host (
canband): On remote Linux servers without a desktop session, pass--headless(curl -fsSL https://canban.dev/install.sh | bash -s -- --headless) to install standalone~/.local/bin/canbanwithout GTK4 dependencies. Activeherdr-coresessions andsystemd --usercanban.serviceunits are preserved across upgrades.
Install mise plus platform build dependencies, then run 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-appCanban builds directly on these open-source projects and assets (full attributions and licenses are preserved in THIRD_PARTY_NOTICES.md):
- Herdr (
herdr-core) — Persistent PTY session supervisor and JSON-RPC runtime powering native Agent CLIs and interactive terminals (Apache-2.0) - Sheprd — Terminal VT/frame/input and subscription utility patterns referenced during integration (Apache-2.0)
- NSH (
longbridge/nsh) — Native macOS (AppKit/Metal) and Linux (GTK4) Rust UI framework (Apache-2.0) - Ghostty (
libghostty-vt) — Commit-pinned VT parser and terminal emulation engine (MIT) - iTerm2-Color-Schemes (MIT) — 16 classic terminal color palettes including Monokai, Dracula, Nord, Tokyo Night, and Catppuccin Mocha
- Lucide (ISC), Lobe Icons (MIT), and Primer Octicons (MIT) — UI and provider icons
Copyright 2026 JJy <jjyruby@gmail.com>.
Licensed under the Apache License, Version 2.0.