CANBAN

CANBAN // INSTALL

安装 Canban

桌面上的原生工作台,服务器上持续运行的 Agent。

Canban macOS 桌面应用界面:Develop 列中的 Card #2 展示独立 Git Worktree、活动时间线、工作流进度条,以及右侧运行 cargo test 的实时 Herdr @developer 终端。
Canban 桌面工作台:左侧集中呈现卡片规格、工作流状态与讨论,右侧实时运行 @developer Herdr PTY 终端。

开始之前

安装 Git 和你选择的 Agent CLI,并完成 Agent 自身的登录或 API 配置。Canban 使用 Herdr Core(hc)运行持久终端会话;首次启动时会引导安装缺失的 Herdr Core。

桌面版

运行以下命令,安装或更新桌面应用。

curl -fsSL https://canban.dev/install.sh | bash

macOS 13.0+ · Apple Silicon

安装 Canban.app 到 /Applications。

Linux · x86_64 / arm64

安装到 ~/.local/opt/canban 并添加应用启动器。需要 GTK4 和 GStreamer 运行库。

Linux 运行库依赖

Ubuntu / Debian

sudo apt install libgtk-4-1 libgstreamer1.0-0 libgstreamer-plugins-base1.0-0

Arch Linux

sudo pacman -S gtk4 gstreamer gst-plugins-base

Fedora

sudo dnf install gtk4 gstreamer1 gstreamer1-plugins-base

Headless Linux 服务器

安装 CLI 和后台服务,无需 GTK4 或桌面环境。通过桌面端使用 SSH 或 Tailscale 连接。请在服务器上安装 Git、Herdr Core、Agent CLI 和项目开发依赖。

curl -fsSL https://canban.dev/install.sh | bash -s -- --headless

更新

再次运行相同的安装命令即可更新已有安装。桌面应用在检测到新版本时也会提供更新入口。

查看版本更新 →

从源码构建

各平台构建依赖和源码安装步骤,请参阅 GitHub README。

GitHub README →

常见问题

Canban 是什么?

Canban 是面向 AI 编程 Agent 的原生看板与终端工作台。它将任务说明、Agent 讨论、开发进度和代码审查集中在卡片中,并通过工作流组织开发与交付。

支持哪些 Agent?

Canban 使用 Herdr 运行 Agent,因此支持 Herdr 所支持的 Agent,例如 Claude Code、Codex、Antigravity、Cursor CLI 和自定义终端 Agent。请先安装所需的 Agent CLI,并完成它自己的登录或 API 配置。

支持哪些操作系统?

Canban 提供 macOS 13.0 及以上 Apple Silicon 版本,以及 Linux x86_64 和 arm64 版本。Linux 桌面版需要 GTK4 和 GStreamer 运行库;无桌面的 Linux 服务器可以使用 Headless 模式。

如何安装和更新?

使用本页的安装命令即可安装或更新 Canban。运行 Agent 还需要 Git、相应的 Agent CLI 和 Herdr Core;首次启动时,Canban 会引导安装缺失的 Herdr Core。各版本改动可在版本更新页查看。

可以在远程服务器上运行 Agent 吗?

可以。在 Linux 服务器上安装 Headless 版本,再通过 SSH 或 Tailscale 从桌面端连接,即可管理远程任务和终端。Agent 及其开发依赖需要安装在执行任务的远程机器上。

Canban 免费吗?

Canban 是采用 Apache-2.0 许可证的免费开源软件。你使用的 Agent、模型 API 或其他服务可能另行收费。