终端 AI 代理统一接口，支持在单一 TUI 界面中并发运行、切换和恢复 Claude Code、Gemini CLI、Codex CLI 等多种编码代理的会话。
Toad 是一个终端 AI 代理统一接口，由 Textual 框架作者 Will McGugan 创建。它支持在单一 TUI 界面中无缝切换、并发运行、恢复会话地使用 Claude Code、Gemini CLI、Codex CLI、OpenHands、Mistral Vibe、OpenCode、Auggie、Kimi CLI、GitHub Copilot 等多种编码代理。
核心能力#
- 代理统一管理：通过 Agent Client Protocol (ACP) 支持扩展新代理，提供 AI "应用商店" 式的发现与安装体验
- 集成 Shell 环境：完整功能的 shell，支持全彩输出、交互式命令、tab 补全，目录变更和环境变量可在命令间持久化
- 高级编辑功能：Markdown 提示编辑器（语法高亮、鼠标支持）、@ 文件选择器（模糊搜索+树形控件）、并排/统一差异对比
- 会话管理：并发会话、Ctrl+R 会话恢复、SQLite 持久化存储
- Web 模式：
toad serve支持浏览器访问
安装方式#
推荐安装：
curl -fsSL batrachian.ai/install | sh
使用 UV 安装：
uv tool install -U batrachian-toad --python 3.14
快速上手#
toad # 启动 TUI
toad ~/projects/my-app # 指定项目目录
toad -a open-hands # 直接启动指定代理
toad serve # Web 服务器模式
快捷键#
| 快捷键 | 功能 |
|---|---|
| F1 | 显示帮助面板 |
| Ctrl+S | 显示所有代理状态 |
| Ctrl+R | 恢复先前会话 |
| Ctrl+B | 切换侧边栏 |
| @ | 添加文件到提示 |
平台支持#
支持 Linux、macOS；Windows 可通过 WSL 运行（原生支持在路线图中）。Python 版本要求 >=3.14。项目采用 AGPL-3.0 许可证，当前版本 0.6.3。