From d0c8c4b31d4a5b37a33adda76611c5993039247e Mon Sep 17 00:00:00 2001 From: ShalokShalom Date: Sun, 26 Apr 2026 18:39:02 +0200 Subject: [PATCH] Correct package for clipboard support Hi. I found that the README suggests xclip for clipboard support. That won't help most users, as this is only for the mostly obsolete X11 desktop environments. I also corrected a couple of grammar issues that Grammarly suggested. --- README.md | 43 +++++++++++++++++++++++-------------------- 1 file changed, 23 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 3c417b70..0500e44d 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ See [Getting Started](#getting-started) if you have any problems. Toad is an interface to coding agents, such as Claude, Gemini, Codex, OpenHand, and many more. -Toad blends a traditional shell based workflow and powerful agentic AI, with an intuitive Terminal User Interface. +Toad blends a traditional shell-based workflow and powerful agentic AI with an intuitive Terminal User Interface. @@ -51,9 +51,9 @@ Toad blends a traditional shell based workflow and powerful agentic AI, with an Find, install, and run dozens of agents directly from the Toad UI.

There is a large and growing list of AI agents that work with Toad. - Discover agents from big tech and smaller Open Source projects. + Discover agents from big tech and smaller open-source projects.

- Developers can add support for their own agents, via the Agent Client Protocol. + Developers can add support for their own agents via the Agent Client Protocol.

@@ -90,9 +90,9 @@ Toad blends a traditional shell based workflow and powerful agentic AI, with an
Screenshot 2026-01-27 at 12 48 30 @@ -64,14 +64,14 @@ Toad blends a traditional shell based workflow and powerful agentic AI, with an

Toad Shell

While most terminal agent interfaces can run commands (with the ! syntax), they aren't running a shell. - If you change directory or set environment variables, they won't persist from one command to the next. + If you change the directory or set environment variables, they won't persist from one command to the next.

Output that contains more than simple text will typically be garbled, and anything interactive will fail or even break the TUI entirely.

Toad integrates a fully working shell with full-color output, interactive commands, and tab completion. Allowing you to interleave prompts for the agent with terminal workflows.

- At time of writing Toad is the only terminal UI which does this. + At the time of writing, Toad is the only terminal UI which does this.

File Picker

- Add a file to your prompt with @, and toad will show a fuzzy file picker. + Add a file to your prompt with @, and Toad will show a fuzzy file picker.

- Type a few characters from the filename or folder and Toad will refine the search as you type. + Type a few characters from the filename or folder, and Toad will refine the search as you type. Hit enter to add the file to the prompt.

The fuzzy picker is great when you know the file you want to mention. @@ -117,7 +117,7 @@ Toad blends a traditional shell based workflow and powerful agentic AI, with an

Elegant Markdown

Markdown is the language of LLMs (AI). - Toad's streaming Markdown support can display syntax highlighted code fences, elegant tables, quotes, lists, and more. + Toad's streaming Markdown support can display syntax-highlighted code fences, elegant tables, quotes, lists, and more.

@@ -131,7 +131,7 @@ Toad blends a traditional shell based workflow and powerful agentic AI, with an

Tune Toad to your liking. Almost everything in Toad may be tweaked. - If you want to create an ultra-minimal UI with nothing more than a prompt—you can! + If you want to create an ultra-minimal UI with nothing more than a prompt, you can!

@@ -177,20 +177,25 @@ https://github.com/user-attachments/assets/ced36f4b-db02-4d29-8a0a-14ec64b22881 Toad runs on Linux and macOS. Native Windows support is currently lacking (but on the roadmap), but Toad will run quite well with WSL. Toad is a terminal application. -Any terminal will work, although if you are using the default terminal on macOS you will get a much reduced experience. -I recommend [Ghostty](https://ghostty.org/) which is fully featured and has amazing performance. +Any terminal will work, although if you are using the default terminal on macOS, you will get a much-reduced experience. +I recommend [Ghostty](https://ghostty.org/), which is fully featured and has amazing performance. ### Clipboard -On Linux, you may need to install `xclip` to enable clipboard support. +On Linux, you may need to install `wl-clipboard` on modern systems, like Gnome and KDE, or `xclip` on X11-based desktops, to enable clipboard support. +On Debian and Ubuntu: +``` +sudo apt install wl-clipboard +``` +or ``` sudo apt install xclip ``` ## Getting Started -The easiest way to install Toad is by pasting the following in to your terminal: +The easiest way to install Toad is by pasting the following into your terminal: ```bash curl -fsSL batrachian.ai/install | sh @@ -206,7 +211,7 @@ First [install UV](https://docs.astral.sh/uv/getting-started/installation/): curl -LsSf https://astral.sh/uv/install.sh | sh ``` -Then use UV to install toad: +Then use UV to install Toad: ```bash uv tool install -U batrachian-toad --python 3.14 @@ -230,7 +235,7 @@ You should see something like this: front-fs8 -From this screen you will be able to find, install, and launch a coding agent. +From this screen, you will be able to find, install, and launch a coding agent. If you already have an agent installed, you can skip the install step. To launch an agent, select it and press space. @@ -276,9 +281,7 @@ toad serve Toad was built by [Will McGugan](https://github.com/willmcgugan) and is currently under active development. -To discuss Toad, see the Discussions tab, or join the #toad channel on the [Textualize discord server](https://discord.gg/Enf6Z3qhVr). - - +To discuss Toad, see the Discussions tab, or join the #toad channel on the [Discord server of Textualize.](https://discord.gg/Enf6Z3qhVr). ### Roadmap @@ -289,9 +292,9 @@ Some planned features: - Sessions (resume) - Multiple agents - Windows native support -- Builtin editor +- Built-in editor - Sidebar (widgets) - - Git pending changes +- Git pending changes ### Reporting bugs