agent-deck

一个终端搞定所有 AI 编程代理会话管理

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 221 🐛 待处理 8 👀 关注 5

GitHub ↗

GitHub 星标 ★ 1234

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

项目数据

分类智能体

开发团队asheshgoplani

GitHubhttps://github.com/asheshgoplani/agent-deck

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Go

技术栈/模型ai-agent,ai-agents,ai-coding-assistant,aider,bubble-tea,claude-code,cli,codex,developer-tools,discord,gemini-cli,golang,mcp,productivity,session-manager,terminal,tmux,tui

GitHub 星标★ 1234

上线时间2025-12-03 00:00:00

代码更新2026-11-09

仓库体积258.5 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

agent-deck 是一个面向 AI 编程代理的终端会话管理器，提供统一的 TUI（终端用户界面）来管理 Claude、Gemini、OpenCode、Codex 等多种 AI 编码工具的会话。它解决了开发者在使用多个 AI 编程助手时，需要在不同终端窗口之间频繁切换、难以集中管理会话上下文的问题。核心能力包括：在单一 TUI 中启动和切换不同 AI 代理、查看会话历史、管理多会话并行运行、支持 Discord 集成（可能用于远程或协作场景）。基于 Go 和 Bubble Tea 构建，界面响应迅速，操作流畅。项目处于早期阶段，但已获得 691 星，显示出社区对其需求的认可。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1234

技术标签

ai-agent ai-agents ai-coding-assistant aider claude-code

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

macOS、Linux 或 Windows(需 WSL) 系统
能访问 GitHub 的网络（安装脚本与源码克隆需要）
从源码安装需要 Go 工具链与 make
已自行安装并登录要管理的 AI 编码工具（Claude、Gemini、Codex 等）

安装与启动步骤

1一键安装

用官方安装脚本把 agent-deck 安装到本地，支持 macOS、Linux 和 Windows 的 WSL 环境。
```
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash
```
2启动 TUI

安装完成后直接运行，打开终端界面，即可查看所有代理会话的运行、等待或完成状态。
```
agent-deck
```
3添加第一个会话

把当前目录作为项目加入，并用 -c 指定使用 Claude 代理。
```
agent-deck add . -c claude
```
4常用会话操作

支持分叉会话、发送多行提示（取自 task.md）、从注册表移除已停止或出错的会话。
```
agent-deck session fork my-proj
agent-deck session send my-proj --message-file task.md
agent-deck session remove my-proj
```
5启动 Web 界面

在本地 8420 端口启动 Web UI，从浏览器查看和管理会话。
```
agent-deck web
```
6其他安装方式

也可用 Homebrew、go install 或克隆源码后 make install 安装，三选一即可。
```
brew install asheshgoplani/tap/agent-deck
```

关键配置

配置项	必填	说明	示例
`ui.new_session_enter_advances`	否	设为 false 可恢复“在任意字段按 Enter 即创建会话”的旧行为	`false`
`docker.default_enabled`	否	新建会话时默认在 Docker 沙箱中运行，隔离宿主系统	`true`
`docker.mount_ssh`	否	把宿主 SSH 目录挂载进沙箱容器	`true`
`docker.auto_cleanup`	否	会话结束后自动删除容器，设为 false 便于排查容器状态	`true`
`worktree.setup_timeout_seconds`	否	worktree 安装脚本的超时时间，超时后仍会创建 worktree	`60`

如何确认成功

运行 agent-deck 能正常打开 TUI 会话列表即安装成功；执行 agent-deck web 后访问 http://127.0.0.1:8420 可确认 Web UI 已启动。

常见问题

Q：Windows 可以直接用吗？

A：README 标注支持 macOS、Linux 和 Windows(WSL)，Windows 需在 WSL 环境里执行安装与运行命令。

Q：怎么卸载 agent-deck？

A：运行 agent-deck uninstall 进入交互式卸载；只想删除二进制而保留会话数据，用 agent-deck uninstall --keep-data。

Q：Docker 沙箱里 Claude 要重新登录吗？

A：宿主工具认证一般会自动共享进容器，但 macOS 上 Claude Code 登录存放在 Keychain，沙箱会保留自己的登录，需在首个沙箱会话执行一次 /login。

Q：怎么给会话挂载 MCP 或技能？

A：用 agent-deck mcp attach my-proj exa 挂载 MCP；用 agent-deck skill attach my-proj docs --source pool --restart 挂载技能并重启会话。

注意事项

新建会话对话框行为在 v1.9.55 变更：Enter 只跳到下一个字段，须点 [ Create session ] 或在任意字段按 Ctrl+S 才会创建会话。
项目处于早期阶段但有较活跃的维护与社区修复，使用前建议查看 README 的最新说明。
worktree 相关配置中 .agent-deck/ 目录必须位于项目根目录，否则 agent-deck 找不到工作树安装脚本。