8000 GitHub - jjyr/canban: Turn Kanban cards into automated coding agent workflows, powered by native CLIs. · GitHub
[go: up one dir, main page]

Skip to content
jjyrPublic

About

Turn Kanban cards into automated coding agent workflows, powered by native CLIs.

Topics

Resources

Stars

27 stars

Watchers

0 watching

Forks

Repository files navigation

Canban icon

Canban

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

Canban Board in Monokai theme


Philosophy

  1. Kanban organizes human context — specs, #Card references, screenshots, @Agent discussions, structured reports, and review gates stay together on each Card.
  2. 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.
  3. 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.

Highlights

Kanban for Human

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.

GitHub Actions Style Workflows

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.

Canban Visual Workflow Studio in Monokai theme

Herdr Terminal

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.

Canban Card Detail and Herdr Terminal split view in Monokai theme


Installation

Prerequisites:

  • macOS: macOS 13.0+ (Apple Silicon / arm64)
  • Linux Desktop: x86_64 or aarch64 (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-click hc setup 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 .desktop launcher 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/canban without GTK4 dependencies. Active herdr-core sessions and systemd --user canban.service units are preserved across upgrades.

Build from Source

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-app

Related Software and Acknowledgements

Canban 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

License

Copyright 2026 JJy <jjyruby@gmail.com>.

Licensed under the Apache License, Version 2.0.

About

Turn Kanban cards into automated coding agent workflows, powered by native CLIs.

Topics

Resources

Stars

27 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0