# batrachianai/toad

A unified interface for AI in your terminal.

Repository: https://github.com/batrachianai/toad
Canonical: https://ross.abutalabs.com/products/toad
Homepage: https://www.batrachian.ai/
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: agents-ui, ai, textual, tui, claude, claude-code, codex-cli, copilot, commercial-license
Last push: 2026-05-26T08:43:50+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 84, release rhythm 86, longevity 29
- inputs: {"age_days": 412, "days_push": 99, "days_rel": 99, "gap_med": 1.0, "n_releases_24m": 45}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3397, forks 155 (observed 2026-08-28T04:08:02.420626+00:00)

## What it is
Toad is a terminal user interface (TUI) that provides a unified interface for running multiple AI coding agents such as Claude Code, Gemini CLI, Codex CLI, and OpenHands. It combines a fully functional shell with agentic AI workflows, an agent 'app store' for discovering and installing agents, and a Markdown prompt editor.

## Use cases
- run multiple AI coding agents from one terminal UI
- interleave shell commands with AI agent prompts
- discover and install AI coding agents
- get a persistent shell alongside an AI agent
- write prompts with a Markdown editor with syntax highlighting
- replace separate CLIs for Claude Code, Codex, and Gemini

## When to choose
- you use several AI coding agents and want one unified interface
- you want a real persistent shell integrated with AI agent workflows
- you prefer terminal-based tools with rich TUI features like mouse support and tab completion

## When to avoid
- you need a GUI or IDE-integrated AI assistant
- you require a permissive open-source license for commercial use (it is AGPL-3.0 with commercial licensing)
- you only use a single AI agent and are happy with its native CLI

## Facets
- artifact type: application
- maturity: active
- function: agent-framework, chat-interface, terminal-ui, cli, developer-tools
- domain: developer-tools, large-language-models
- platform: python, cli
- tags: tui, coding-agents, claude-code, codex-cli, copilot, agent-client-protocol, shell-integration, textual, ai-agents, command-line, macos, linux

## Member repositories
- batrachianai/toad (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:02.420626+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:38:47.948045+00:00, confidence not recorded.
  - readme: https://github.com/batrachianai/toad (fetched 2026-08-28T04:08:02.420626+00:00, sha 7e5b6f196c7d)
  - homepage: https://www.batrachian.ai/ (fetched 2026-08-29T09:33:02.711104+00:00, sha 0a8f8e2f87d4)
- Data as of 2026-08-30T08:39:29.467469+00:00.
