Toad

Toad is a unified TUI interface for AI coding agents, created by Will McGugan (author of the Textual framework). It enables seamless switching, concurrent execution, and session resumption across Claude Code, Gemini CLI, Codex CLI, OpenHands, Mistral Vibe, OpenCode, Auggie, Kimi CLI, GitHub Copilot, and more.

Core Capabilities#

• Unified Agent Management: Agent Client Protocol (ACP) for extending new agents, with an AI "app store" for discovery and installation
• Integrated Shell: Full-featured shell with full-color output, interactive commands, tab completion, and persistent directory/environment changes
• Advanced Editing: Markdown prompt editor (syntax highlighting, mouse support), @ file picker (fuzzy search + tree widget), side-by-side/unified diff views
• Session Management: Concurrent sessions, Ctrl+R session resumption, SQLite-based persistence
• Web Mode: toad serve for browser access

Installation#

Recommended:

curl -fsSL batrachian.ai/install | sh

Using UV:

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

Quick Start#

toad                          # Launch TUI
toad ~/projects/my-app        # Specify project directory
toad -a open-hands            # Launch specific agent directly
toad serve                    # Web server mode

Keyboard Shortcuts#

Platform Support#

Supports Linux, macOS; Windows via WSL (native support in roadmap). Requires Python >=3.14. Licensed under AGPL-3.0, current version 0.6.3.