Agent Deck

一个终端 TUI,统一管理 Claude Code、Codex、Gemini CLI 等所有 AI 编码代理会话,随时查看状态并一键切换。

Star 数
★ 1.2k
最近更新
1 天前
License
MIT
主语言
Go

30 秒速览

运行形态
命令行工具网页应用
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
tmuxGo 1.25.13(从源码构建)Docker(可选沙箱)Shell / 命令行网络访问本地文件系统
典型场景
同时运行多个 Claude Code 项目会话的开发者,需要一个终端视图查看全部运行/等待状态并一键切换
不适合
  • 原生 Windows 用户:不支持非 WSL 环境
  • 不愿安装 tmux 的用户:tmux 是硬性运行时依赖
  • 需要开箱即用、免配置的团队:config.toml 配置面较大
维护状态
近 30 天有提交最近提交 2026-11-09最新版本 v1.16.38(2026-11-07)近 7 天每天 +5.0 ★

这个 Agent 能做什么,适合哪些场景?

Agent Deck 是一个用 Go 编写的终端会话管理器,基于 tmux 与 Bubble Tea TUI 构建,用于集中管理多个 AI 编码代理会话。它实时检测每个会话的状态(运行、等待、空闲、错误),支持分组、模糊搜索、会话分叉、git worktree 隔离与成本追踪。除 TUI 外还提供 Web UI(默认 127.0.0.1:8420)、CLI 子命令以及可选的 Telegram/Slack 远程通道。'Conductor' 机制允许一个常驻代理会话监控并编排其他会话,必要时通过手机通知升级处理。项目采用 MIT 许可证,支持 macOS、Linux 与 Windows WSL。

Agent Deck 在 tmux 中为每个 AI 代理(Claude Code、Codex、Gemini CLI、OpenCode、Copilot、Crush、Cursor 等及自定义工具)创建会话,通过智能轮询检测状态并在 TUI 列表中以符号显示(● 运行、◐ 等待、○ 空闲、✕ 错误)。核心操作包括:agent-deck add . -c claude 将目录注册为会话;按 f 或 F 通过工具原生 fork 支持分叉 Claude/OpenCode/Pi/Codex 会话(可继承 worktree、未提交状态与 Docker 隔离);session fork、session send(多行提示)、session switch-account(迁移对话文件到另一 Claude 账户并 --resume 重启);MCP 管理器(按 m)无需改配置文件即可按项目或全局启停 MCP 服务器;Skills 管理器(按 s)管理 Claude 技能池并写入 .agent-deck/skills.toml;git worktree 子系统创建隔离工作目录,支持 .worktreeinclude 复制 gitignore 文件与 .agent-deck/worktree-setup.sh/worktree-destruction.sh 脚本;conductor setup 创建监控型代理会话并可选接入 Telegram/Slack 桥接;watcher create 提供 webhook、GitHub、ntfy、Slack 四种事件适配器;成本仪表盘(按 $)通过 Claude hook 读取 transcript 统计 15 种模型的 token 与费用,支持预算限额与 CSV/JSON 导出;Docker 沙箱可将会话装入隔离容器并共享宿主工具认证。

  1. 同时运行多个 Claude Code 项目会话的开发者,需要一个终端视图查看全部运行/等待状态并一键切换
  2. 需要在同一仓库并行运行多个代理的开发团队,用 git worktree 避免分支冲突
  3. 关注 API 开销的个人用户,通过成本仪表盘和每日/每周/每月预算限额控制 token 支出
  4. 希望在手机上监控和指挥代理集群的远程工作者,通过 Telegram/Slack 桥接的 Conductor 接收升级通知
  5. 在大型 monorepo 中使用 sparse checkout 的工程师,让新 worktree 继承稀疏配置避免全量检出
  6. 需要为不同会话组使用不同 Claude 账户或配置目录的用户,通过 per-group CLAUDE_CONFIG_DIR 覆盖实现

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash
  • brew install asheshgoplani/tap/agent-deck
  • go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest
配置文件
XDG_CONFIG_HOME/agent-deck/config.toml ~/.config/agent-deck/config.toml
安装说明涉及
Windows · macOS · Linux · WSL

如何安装或部署这个 Agent?

支持 macOS、Linux、Windows (WSL)。最简安装:curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash,然后运行 agent-deck。其他方式:Homebrew brew install asheshgoplani/tap/agent-deck;Go 安装 go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest;源码安装 git clone https://github.com/asheshgoplani/agent-deck.git && cd agent-deck && make install。卸载可用 agent-deck uninstall(--keep-data 保留会话数据)。

如何使用这个 Agent?

启动 TUI:agent-deck。常用入口:agent-deck add . -c claude 将当前目录添加为 Claude 会话;n 新建会话(Ctrl+S 提交,Enter 换字段);Enter 附着到会话,Ctrl+Q 脱离;f/F 分叉;A/Shift+U 归档/恢复;m 打开 MCP 管理器,s 打开技能管理器,$ 打开成本仪表盘,/ 模糊搜索,? 查看全部快捷键。编排舰队:先在 Telegram @BotFather 创建机器人,然后 agent-deck conductor setup work --description "Work fleet",agent-deck session start conductor-work,之后向机器人发 /status 即可查询。Web UI:agent-deck web(默认 http://127.0.0.1:8420,--read-only 只读,--token 保护 API)。远程管理:agent-deck remote add dev user@dev-box 后可 remote sessions、remote attach、remote drain。配置位于 $XDG_CONFIG_HOME/agent-deck/config.toml(默认 ~/.config/agent-deck/config.toml)。注意 Codex 状态检测需先运行 agent-deck codex-hooks install 安装 notify hook。

这个 Agent 有哪些优点和局限?

优点
  • 多工具统一管理:Claude Code、Gemini CLI、OpenCode、Codex、Copilot、Crush、Cursor、DeepSeek Harness 及自定义工具均可在同一 TUI 中管理,状态检测按工具深度不同分级集成
  • Conductor + Watcher 编排体系:一个常驻代理会话监控全部子会话,支持 Telegram/Slack 远程通道和 webhook/GitHub/ntfy/Slack 四种事件适配器,事件在 SQLite 中去重
  • 会话分叉继承完整上下文:通过工具原生 fork 支持,quick fork 默认同时创建 worktree、携带未提交状态并匹配 Docker 隔离
  • 成本可视化完善:15 种模型定价、每日价格刷新、多维度预算限额(80% 警告、100% 硬停)与历史 transcript 回填
  • 活跃维护:README 声明 PR 约一天内验证,社区修复持续合入,并公开招募共同维护者
局限
  • 强依赖 tmux 运行时;无 tmux 的环境(如原生 Windows 非 WSL)不适用
  • 深度集成偏向 Claude Code:成本追踪自动收集仅 Claude hook 完整支持,Gemini/Codex/MiniMax 靠输出解析且标注为未测试
  • 部分功能文档明确标注未测试(Gemini/Codex 成本解析、预算硬停),生产可靠性需自行验证
  • Codex 完整状态检测依赖手工安装 notify hook(agent-deck codex-hooks install),Codex fork 还要求 codex CLI 支持 codex fork(验证于 codex-cli 0.137.0)
  • 配置面较大:config.toml 涉及 groups、profiles、conductors、worktree、fork、docker、costs 等多个区块,学习成本不低

这个 Agent 与同类方案有什么区别?

README 将其定位为 tmux 之上的 AI 代理会话管理层,并与 Claude Code Desktop 的 worktree gitignore 复制语义对齐(.worktreeinclude),同时支持 Codex 兼容的自定义工具分叉。README 未点名直接竞品,但相比裸用 tmux,它提供了状态检测、成本追踪、Conductor 编排等 tmux 本身不具备的能力。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Agent Deck 当前 74 · 存在缺口 命令行工具免费 + 模型费 ★ 1.2k 1 天前 Go Codex · Claude Code
Agent Manager 75 · 表现良好 命令行工具免费 ★ 684 今天 Go Codex · Claude Code
dev-3.0 76 · 表现良好 桌面应用 ★ 332 1 天前 TypeScript Codex · Claude Code
Diri 75 · 表现良好 桌面应用免费 + 模型费 ★ 487 1 天前 Rust Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
74/ 100 五分制 3.7 / 5
信任安全 19/29
可靠稳定 9/14
适用触发 14/18
规范维护 15/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

材料说明可按本地/全局范围附加 MCP,并明确要求只在用户请求时操作;账号切换会先提示确认,远程切换在远端处理且转录和凭据不离开远端,因此最小权限、确认和数据流有实质控制。遥测/崩溃报告有配置和同意说明,安全策略列出依赖扫描与签名构建;但未提供完整实现供核对,外部副作用、凭据保护与依赖风险控制仍非全面可证。删除有撤销栈和信号退出时最终清理的说明,但恢复范围并未完全展开。仓库名、许可证和安全联系渠道明确;发布者身份仍未验证。

可靠稳定9 / 14 · 3.2/5

README 与技能文件提供大量一致的命令、行为和边界说明,版本号也可见;Go 模块列出依赖,但材料没有锁定安装环境的完整可用性证据。错误示例、失败关闭行为及未确认投递不重试等说明较具体。扣分是这些静态材料无法证明所有文档与实现一致,也无法核验普通运行中的依赖故障表现。

适用触发14 / 18 · 3.9/5

产品覆盖多种编码代理、会话编排、远程会话、工作树、终端与 Web 场景,并提供平台范围和大量具体配置。技能触发描述清晰列出适用和不适用情形;README 也指出远程行不支持主菜单消息编辑器等能力边界。扣分是材料对不支持平台/代理组合和所有环境差异的界定不完整。

规范维护15 / 18 · 4.2/5

文档层级清楚,README 有安装、快速开始、快捷键、功能、FAQ 与故障排查入口;许可证文件完整。已知限制写得具体,包括版本、上下文窗口推断、远程消息编辑器和未实施的组扩张警告。版本信息和发布说明入口存在,但没有在给定材料中看到完整变更历史;维护者和贡献流程有自述及安全联系信息,但发布者身份未经验证,维护承诺也主要是仓库自述。

有效结果12 / 13 · 4.6/5

TUI/CLI 将多代理会话集中管理,并支持搜索、分组、分叉、成本跟踪、队列消息和手机控制的 conductor,输出可通过文本、JSON、复制和报告等方式使用,解决了明确的多会话管理负担。维护与配置开销仍较高:需要 tmux、外部代理 CLI,部分功能还需配置 MCP、watcher 或消息平台;材料未量化这些成本。

证据核验5 / 8 · 3.1/5

README 的命令和关键行为能在技能参考文档、配置示例、安全策略及源代码片段中找到部分对应,贡献说明也列出 CI 和测试流程。材料明确区分了推断窗口与已知窗口,并对若干限制作了说明。扣分是交付材料只是文件样本,许多产品声明没有对应实现或测试片段可交叉核对;CI 声明是仓库文本而非本次独立验证。

风险与缓解建议
  • 安装示例通过 curl 将远程脚本直接交给 bash;使用者应先审阅脚本并确认来源。
  • Conductor、watcher、MCP 和 env_file 能触发外部通信或向会话环境注入变量;配置前应检查接收端、作用范围与文件内容。
  • 本评估仅依据提供的静态文件样本,未执行程序或独立验证测试、发布产物及安全声明。
证据充分度:低 评估于 2026年11月8日 审查版本 82f89da93587 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agent-deck.svg?lang=zh)](https://followagents.com/zh/agents/agent-deck)
<a href="https://followagents.com/zh/agents/agent-deck"><img src="https://followagents.com/badge/agent-deck.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.16.38
    发布说明摘录
    Agent Deck v1.16.38 Terminal session manager for AI coding agents. Installation Homebrew (recommended): ```bash brew install asheshgoplani/tap/agent-deck ``` Quick Install: ```bash curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash ``` Go Install: ```bash go install github.com/asheshgoplani/agent-deck/cmd/[email protected] ``` Changelog * c4967fab0b13c784a42f508ab19c774b8eb613f6 feat(hooks): record a monotonic turn_seq per instance (step 1 of #3012) (#3080) …
    在 GitHub 查看 ↗
  2. v1.16.37
    发布说明摘录
    Agent Deck v1.16.37 Terminal session manager for AI coding agents. Installation Homebrew (recommended): ```bash brew install asheshgoplani/tap/agent-deck ``` Quick Install: ```bash curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash ``` Go Install: ```bash go install github.com/asheshgoplani/agent-deck/cmd/[email protected] ``` Changelog * 49bb0c222d1d6a5f60eed37eeeffcaf2e0107f52 build(deps): bump the go-minor-patch group with 3 updates (#3028) …
    在 GitHub 查看 ↗
  3. v1.16.36
    发布说明摘录
    Agent Deck v1.16.36 Terminal session manager for AI coding agents. Installation Homebrew (recommended): ```bash brew install asheshgoplani/tap/agent-deck ``` Quick Install: ```bash curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash ``` Go Install: ```bash go install github.com/asheshgoplani/agent-deck/cmd/[email protected] ``` Changelog * 3750e095af431912b1f5658ba774d27ea895c367 ci(release): reuse the green Go tests result for the tag sha instead of re-running the suite (#2929) (#3004) …
    在 GitHub 查看 ↗

常见问题

使用它需要付费吗?遥测会收集数据吗?
Agent Deck 本身是 MIT 许可的免费开源软件。用量遥测默认关闭且为选择加入(agent-deck telemetry enable),AGENTDECK_TELEMETRY=0 或 DO_NOT_TRACK=1 可硬性禁用;代理本身的 API 费用由所用的各家工具计费,Agent Deck 的成本仪表盘可帮你追踪。
必须使用 Claude Code 吗?
不是。它支持 Codex、Gemini CLI、OpenCode、Copilot、Crush、Cursor、DeepSeek Harness 等工具,并可通过 config.toml 的 [tools.*] 配置自定义工具;但对 Claude Code 的集成最完整(状态、MCP、fork、resume、成本 hook)。
如果某个代理会话出错或卡住怎么办?
TUI 以 ✕ 红色标记错误状态,R 可重启会话;Conductor 会在子会话进入 waiting/error/idle 时发送通知,可选的 Watchdog 守护进程能自动重启关键会话。
Web UI 暴露在网络上安全吗?
默认只绑定 127.0.0.1:8420。绑定非回环地址必须配置 --token 或 --token-file,否则会被拒绝,因为会暴露未认证的远程代码执行面;MCP 管理 API 仅在有 token 时可用。
多个代理同时改同一个仓库会冲突吗?
不会必然冲突:Agent Deck 的 git worktree 功能让每个会话在独立工作目录和分支中运行,支持 .worktreeinclude 复制 gitignore 文件和 setup/destruction 脚本,worktree finish 可一键合并并清理。
Agent Deck 开源吗?
开源。源码在 GitHub(asheshgoplani/agent-deck),许可证是 MIT。
Agent Deck 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-09,在最近 30 天内。最新版本是 v1.16.38(2026-11-07)。
Agent Deck 是谁开发的?
Agent Deck 由 GitHub 账号 asheshgoplani 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。