Toad

在你的终端中使用 AI 的统一界面（发布公告）。

快速入门

安装：

curl -fsSL batrachian.ai/install | sh

运行：

toad

如果遇到任何问题，请参阅 入门指南。

Toad 是什么？

Toad 是一个用于代码生成代理的界面，例如 Claude、Gemini、Codex、OpenHand 等众多工具。

Toad 将传统的 shell 工作流程与强大的代理式 AI 相结合，提供了一个直观的终端用户界面。

AI“应用商店” 您可以直接从 Toad 的用户界面中查找、安装并运行数十种代理。 支持 Toad 的 AI 代理数量庞大且不断增长。您可以发现来自大型科技公司以及小型开源项目的代理。 开发者可以通过 代理客户端协议 为自己的代理添加支持。
Toad Shell 虽然大多数终端代理界面可以运行命令（使用 ! 语法），但它们并不真正运行 shell。如果您更改目录或设置环境变量，这些更改不会在后续命令中保留。 包含纯文本以外内容的输出通常会乱码，而任何交互式操作都可能失败，甚至完全破坏 TUI。 Toad 集成了一个功能完善的 shell，支持全彩色输出、交互式命令和 Tab 补全。这让您可以将对代理的提示与终端工作流交织在一起。 截至目前，Toad 是唯一具备此功能的终端 UI。
提示编辑器 Toad 配备了一个优秀的 Markdown 提示编辑器，支持代码块的语法高亮。它还提供完整的鼠标支持、剪切和粘贴功能，以及丰富的快捷键和快捷方式。
文件选择器 使用 @ 可以将文件添加到您的提示中，Toad 会显示一个模糊文件选择器。 只需输入文件名或文件夹的部分字符，Toad 就会在您输入时逐步缩小搜索范围。按下 Enter 即可将文件添加到提示中。 当您知道要引用的文件时，这个模糊选择器非常方便。如果您想浏览文件，可以按 Tab 切换到交互式树状控件。
精美的差异对比 支持并排或统一格式的差异对比，并为大多数编程语言提供语法高亮。
优雅的 Markdown Markdown 是 LLM（人工智能）的语言。Toad 对流式 Markdown 的支持可以显示语法高亮的代码块、美观的表格、引用、列表等。
简单的设置 直观的设置系统（无需手动编辑 JSON 文件）。 根据您的喜好调整 Toad。 Toad 中几乎所有的功能都可以自定义。如果您希望创建一个仅包含提示的极简 UI，这也是完全可以实现的！
并发会话 您可以同时启动并运行来自不同提供商的多个代理。 按下 Ctrl+S 可以在一个屏幕上查看所有代理的当前状态。
会话恢复 您可以恢复与代理之前的会话。 按下 Ctrl+R 即可选择之前的一次会话进行恢复。

视频

观看 Toad 用户界面的预览：

https://github.com/user-attachments/assets/ced36f4b-db02-4d29-8a0a-14ec64b22881

兼容性

Toad 支持 Linux 和 macOS。目前尚不原生支持 Windows（但已在开发计划中），不过通过 WSL 仍然可以很好地运行 Toad。

Toad 是一个终端应用程序。 任何终端都可以使用，但如果您使用的是 macOS 的默认终端，则体验会大打折扣。 我推荐 Ghostty，它功能齐全且性能出色。

剪贴板

在 Linux 上，您可能需要安装 xclip 来启用剪贴板支持。

sudo apt install xclip

开始使用

安装 Toad 的最简单方法是在终端中粘贴以下命令：

curl -fsSL batrachian.ai/install | sh

现在你应该已经成功安装了 toad。

如果由于某种原因上述方法无法正常工作，你可以按照以下步骤进行安装：

首先 安装 UV：

curl -LsSf https://astral.sh/uv/install.sh | sh

然后使用 UV 安装 toad：

uv tool install -U batrachian-toad --python 3.14

Toad 也可以在 conda-forge 上找到，并且可以使用 pixi 进行安装：

pixi global install batrachian-toad

使用 Toad

通过以下命令启动 Toad：

toad

你应该会看到类似这样的界面：

从这个界面，你可以查找、安装并启动一个编码代理。如果你已经安装了代理，可以跳过安装步骤。要启动某个代理，只需选中它并按下 空格键。

页脚始终会显示当前上下文中最重要的快捷键。如果想查看所有快捷键，可以按下 F1 键来打开帮助面板。

Toad 命令行界面

运行 Toad 时，默认的当前工作目录会被视为你的项目目录。如果你想使用其他项目目录，可以在命令中添加路径。例如：

toad ~/projects/my-awesome-app

如果你想跳过初始的代理选择界面，可以加上 -a 参数，并指定你想要使用的代理名称。例如：

toad -a open-hands

要查看所有子命令和选项，可以添加 --help 参数：

toad --help

Web 服务器

你也可以将 Toad 作为 Web 应用程序运行。

运行以下命令，并点击终端中显示的链接：

toad serve

Toad 开发

Toad 由 Will McGugan 构建，目前仍在积极开发中。

如需讨论 Toad，请前往“讨论”标签页，或加入 Textualize Discord 服务器 中的 #toad 频道。

路线图

一些计划中的功能：

• MCP 服务器的用户界面
• 暴露模型选择功能（等待 ACP 更新）
• 会话功能（恢复）
• 多个代理支持
• Windows 原生支持
• 内置编辑器
• 侧边栏（小部件）
  • Git 待处理更改

报告 Bug

该项目正在尝试一种非传统的问题处理方式。在创建问题之前，必须先在“讨论”版块中发布帖子，并由 Toad 的开发者（目前是 @willmcgugan）批准。

通过允许讨论在“讨论”标签页中进行，我们可以将问题保留给那些具有明确描述和目标的可执行任务。

许可证

Toad 采用 AGPL 许可证授权。商业许可证也可提供。详情请参阅 COMMERCIAL_LICENSE.md。

Toad 快速上手指南

Toad 是一款运行在终端的统一 AI 编程助手界面。它将传统的 Shell 工作流与强大的 AI Agent（如 Claude、Gemini、OpenHand 等）相结合，提供直观的终端用户界面（TUI），支持完整的 Shell 交互、文件选择、代码高亮及多会话管理。

环境准备

系统要求

• 操作系统：Linux 或 macOS。
  • 注：原生 Windows 支持尚在开发中，Windows 用户建议使用 WSL (Windows Subsystem for Linux) 运行。
• 终端模拟器：任意终端均可运行。
  • 推荐：macOS 用户强烈推荐使用 Ghostty 以获得最佳性能和完整功能体验；默认终端可能导致功能受限。

前置依赖

• 剪贴板支持 (Linux)：若需在 Linux 上使用复制/粘贴功能，需安装 xclip：

  sudo apt install xclip
  

• Python 环境：安装脚本会自动处理依赖，若手动安装则需 Python 3.14+ 及 UV 工具。

安装步骤

方法一：一键安装（推荐）

在终端中执行以下命令即可自动下载并安装 Toad：

curl -fsSL batrachian.ai/install | sh

方法二：使用 UV 工具安装

如果一键安装失败，可先安装 UV，再通过 UV 安装 Toad：

1. 安装 UV：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 使用 UV 安装 Toad：

   uv tool install -U batrachian-toad --python 3.14
   

方法三：使用 Pixi 安装

如果你使用 pixi 包管理器：

pixi global install batrachian-toad

基本使用

启动 Toad

安装完成后，直接在终端输入以下命令启动：

toad

启动后你将看到 Agent 选择界面：

1. 浏览并选择所需的 AI 编程助手（Agent）。
2. 按 Space 键启动选中的 Agent。
3. 按 F1 查看当前上下文的所有快捷键帮助。

指定项目目录

Toad 默认将当前目录作为项目根目录。若要指定其他项目路径，可在命令后附加路径：

toad ~/projects/my-awesome-app

直接启动特定 Agent

若已安装过某个 Agent 并希望跳过选择界面，可使用 -a 参数直接启动：

toad -a open-hands

以 Web 应用模式运行

Toad 支持作为 Web 服务运行，方便在浏览器中使用：

toad serve

运行后点击终端输出的链接即可在浏览器中访问。

核心功能提示

• 文件引用：在输入框输入 @ 可唤起模糊搜索文件选择器，快速将文件内容加入提示词。
• Shell 集成：支持完整的 Shell 交互，包括目录切换、环境变量设置及交互式命令，状态在不同命令间持久化。
• 多会话管理：按 Ctrl+S 查看所有运行中的 Agent 会话；按 Ctrl+R 恢复历史会话。