toad

Name: toad
Author: batrachianai

by batrachianai

Verified

A unified interface for AI in your terminal.

3,300stars

153forks

Python

Added 3/15/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/batrachianai/toad

Getting Started

Guides for using ai agents skills like toad.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 4/22/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-04-22T06:01:10.831Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is toad?

toad is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by batrachianai. A unified interface for AI in your terminal. It has 3,300 GitHub stars.

Is toad safe to use?

Yes. toad passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install toad?

Clone the repository with "git clone https://github.com/batrachianai/toad" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is toad written in?

toad is primarily written in Python. It is open-source under batrachianai on GitHub, so you can review or fork the full source.

Are there alternatives to toad?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh toad against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

mirage claude-code-rev

Toad

A unified interface for AI in your terminal (release announcement).

Quickstart

Install:

curl -fsSL batrachian.ai/install | sh

Run:

toad

See Getting Started if you have any problems.

What is Toad?

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.

Video

Watch a preview of the Toad User Interface:

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

Compatibility

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 which is fully featured and has amazing performance.

Clipboard

On Linux, you may need to install xclip to enable clipboard support.

sudo apt install xclip

Getting Started

The easiest way to install Toad is by pasting the following in to your terminal:

curl -fsSL batrachian.ai/install | sh

You should now have toad installed.

If that doesn't work for any reason, then you can install with the following steps:

First install UV:

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

Then use UV to install toad:

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

Toad is also available on conda-forge, and can be installed using pixi:

pixi global install batrachian-toad

Using Toad

Launch Toad with the following:

toad

You should see something like this:

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.

The footer will always display the most significant keys for the current context. To see all the keys, press F1 to display the help panel.

Toad CLI

When running Toad, the current working directory is assumed to be your project directory. To use another project directory, add the path to the command. For example:

toad ~/projects/my-awesome-app

If you want to skip the initial agent screen, add the -a switch with the name of your chosen agent. For example:

toad -a open-hands

To see all subcommands and switches, add the --help switch:

toad --help

Web server

You can run Toad as a web application.

Run the following, and click the link in the terminal:

toad serve

textual-serve

Toad development

Toad was built by Will McGugan and is currently under active development.

To discuss Toad, see the Discussions tab, or join the #toad channel on the Textualize discord server.

Roadmap

Some planned features:

Reporting bugs

This project is trialling a non-traditional approach to issues. Before an issue is created, there must be a post in Discussions, approved by a Toad dev (Currently @willmcgugan).

By allowing the discussions to happen in the Discussion tabs, issues can be reserved for actionable tasks with a clear description and goal.

Licensing

Toad is licensed under the AGPL license. Commercial licenses are available. See COMMERCIAL_LICENSE.md.