Agent Deck
一个终端 TUI，统一管理 Claude Code、Codex、Gemini CLI 等所有 AI 编码代理会话，随时查看状态并一键切换。
证据显示该工具以较低侵入方式包装既有 agent CLI，删除/卸载有 --keep-data 与 transcript 保留等保护，.worktreeinclude 复制机密文件时有 gitignored-only 且不覆盖的护栏，SECURITY.md 声明了 Dependabot/govulncheck/CodeQL/SHA-pinning/SLSA 证明等供应链措施。扣分点：govulncheck 与 Dependabot 配置本身未在所给文件中出现（仅断言）；env_file 被 source 进 shell、curl|bash 安装、SSH/Telegram 远程控制等高权限面存在，但缺乏独立的用户确认与最小权限文档；conductor 向 Telegram/Slack/Discord 等外部通道发送会话状态，数据流虽有文档但敏感边界描述薄弱。
README 与 workflow 文档内部一致（v1.7.42→v1.7.70 的删除与恢复叙事、v1.10.9-11 无证明的缺口在 SECURITY.md 与 workflows/README.md 相互印证），go.mod 锁定依赖版本，conductor 测试对 stderr 分类与失败路径有覆盖。扣分点：提供的测试片段仅覆盖 conductor 桥的一小部分；对外部 CLI（claude/codex/tmux/git 版本）的可用性依赖只能在文档层面确认，无法静态验证；具体 TUI 运行期失败消息质量未在证据中直接展示。
受众与场景描述极其清晰（多项目多 agent 的终端会话管理），平台（macOS/Linux/WSL）、git 2.32+、tmux 等环境要求明确，快捷键与 CLI 触发定义精确。扣分点：对 Windows 原生、非 tmux 环境的支持未明确；能力边界多为叙述性说明（如 codex fork 需特定 CLI 版本），缺乏系统性边界清单。
信息架构出色（安装→快速开始→功能→文档→FAQ 层次分明），安装方式多样且含卸载说明，已知局限罕见地坦诚（未签名 release、被移除的 workflow、无群组蔓延告警等均有记录），MIT 许可完整含版权行。扣分点：CHANGELOG 文件本身未在证据中出现（版本变更散见于 README）；维护为单人主导、共同维护者尚在招募中，长期维护承诺只是意图表述；naming_stability 讨论详尽但本质是约定而非强制。
边际价值明确：统一 TUI 管理多种 AI agent 会话、fork、worktree、成本追踪、手机端 conductor，属于同类中功能密集的工具。扣分点：输出可用性（TUI 实际体验、web UI 质量）无法静态验证；引入了庞大的依赖树（GCP pubsub、grpc、websocket 等）与大量常驻组件（bridge daemon、heartbeat），对只想简单管理会话的用户成本偏高，收益-成本权衡依赖用户实际使用全部功能。
关键声明普遍可追溯（关联 issue #602、#1760、#1759、#682，提供 scripts/verify-per-group-claude-config.sh 等人可运行验证脚本，gh attestation verify 命令可直接执行），'verified with codex-cli 0.137.0' 与 'hand check is not a signature' 等表述区分了事实与推断。扣分点：大量功能声明（85-90% 内存节省、~3 秒自动恢复、PR 一天内验证）无随附数据支撑；跨文件印证仅覆盖少数点（release 缺口），其余主张依赖单一 README 来源；本次仅为静态审查，未执行任何验证。
- conductor/watcher 会把会话状态与内容推送到 Telegram/Slack/Discord 等外部通道，部署前应确认 bot token 存储与消息内容的敏感边界。
- install.sh 采用 curl | bash 模式，且 v1.10.9–v1.10.11 三个版本无 SLSA 证明（官方已自曝该缺口）；安装前建议改用可校验 checksum 的方式并运行 gh attestation verify。
- .worktreeinclude 可将 .env、secrets/ 等 gitignored 文件复制进新 worktree，多 worktree 场景会放大机密副本数量，注意清理。
- per-group/per-conductor env_file 会被 source 进 tmux pane，env 变量优先级链（env > conductor > group > profile > global）较复杂，误配置可能导致会话使用错误账户。
- 工具依赖外部 CLI（claude、codex、tmux、git ≥2.32 于 sparse 功能），环境不满足时部分功能静默降级或不可用。
- 发布者未经企业注册表验证，身份为未知；维护以单人为主，长期维护强度存在不确定性。
这个 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 沙箱可将会话装入隔离容器并共享宿主工具认证。
- 同时运行多个 Claude Code 项目会话的开发者，需要一个终端视图查看全部运行/等待状态并一键切换
- 需要在同一仓库并行运行多个代理的开发团队，用 git worktree 避免分支冲突
- 关注 API 开销的个人用户，通过成本仪表盘和每日/每周/每月预算限额控制 token 支出
- 希望在手机上监控和指挥代理集群的远程工作者，通过 Telegram/Slack 桥接的 Conductor 接收升级通知
- 在大型 monorepo 中使用 sparse checkout 的工程师，让新 worktree 继承稀疏配置避免全量检出
- 需要为不同会话组使用不同 Claude 账户或配置目录的用户，通过 per-group
CLAUDE_CONFIG_DIR覆盖实现
这个 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？
支持 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 与同类方案有什么区别？
README 将其定位为 tmux 之上的 AI 代理会话管理层，并与 Claude Code Desktop 的 worktree gitignore 复制语义对齐（.worktreeinclude），同时支持 Codex 兼容的自定义工具分叉。README 未点名直接竞品，但相比裸用 tmux，它提供了状态检测、成本追踪、Conductor 编排等 tmux 本身不具备的能力。
常见问题
使用它需要付费吗？遥测会收集数据吗？
agent-deck telemetry enable），AGENTDECK_TELEMETRY=0 或 DO_NOT_TRACK=1 可硬性禁用；代理本身的 API 费用由所用的各家工具计费，Agent Deck 的成本仪表盘可帮你追踪。必须使用 Claude Code 吗？
[tools.*] 配置自定义工具；但对 Claude Code 的集成最完整（状态、MCP、fork、resume、成本 hook）。如果某个代理会话出错或卡住怎么办？
R 可重启会话；Conductor 会在子会话进入 waiting/error/idle 时发送通知，可选的 Watchdog 守护进程能自动重启关键会话。Web UI 暴露在网络上安全吗？
--token 或 --token-file，否则会被拒绝，因为会暴露未认证的远程代码执行面；MCP 管理 API 仅在有 token 时可用。多个代理同时改同一个仓库会冲突吗？
.worktreeinclude 复制 gitignore 文件和 setup/destruction 脚本，worktree finish 可一键合并并清理。