# 安装 Canban

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

![Canban macOS 桌面应用界面：Develop 列中的 Card #2 展示独立 Git Worktree、活动时间线、工作流进度条，以及右侧运行 cargo test 的实时 Herdr @developer 终端。](https://canban.dev/screenshots/board-terminal.png)

*Canban 桌面工作台：左侧集中呈现卡片规格、工作流状态与讨论，右侧实时运行 @developer Herdr PTY 终端。*

## 开始之前

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

## 桌面版

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

```sh
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 运行库依赖

```sh
# 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 和项目开发依赖。

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

## 更新

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

## 从源码构建

各平台构建依赖和源码安装步骤，请参阅 GitHub README。 (https://github.com/jjyr/canban#build-from-source)

## 常见问题

### 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 或其他服务可能另行收费。
