OpenHands Partners with Toad: A Universal Terminal Interface for AI Agents

8 min read

Written by

OpenHands Team

Published on

December 18, 2025

Terminal-based AI coding assistants have grown rapidly in popularity. Tools like Claude Code, Gemini CLI, and OpenHands CLI give developers the ability to interact with AI agents directly in the terminal—the environment where many of us spend most of our working day.

But each tool comes with its own interface, its own quirks, and its own limitations. What if there was a universal interface that could work with any AI agent?

That's the vision behind Toad, a project by Will McGugan, the creator of the popular Python libraries Rich and Textual. OpenHands is proud to be a sponsor of Toad's development and one of its recommended agents.

What is Toad?

Toad is a universal terminal interface for AI agents. The name comes from "textual code"—combining the Textual framework with coding assistance. Built on the Textual library, Toad provides a modern terminal user experience that goes beyond what traditional command-line tools offer.

Toad addresses several limitations common to existing terminal-based AI tools:

No flickering or visual artifacts. Many terminal AI tools suffer from flickering as they update content. Toad can update partial regions of the screen—down to a single character—without redrawing everything.

Scrollback that works. You can scroll back through your conversation history and interact with previous outputs, including copying text without garbled formatting.

A unified experience. Instead of learning different interfaces for different AI agents, Toad provides a consistent experience across all supported agents through the Agent Client Protocol (ACP).

The Agent Client Protocol

Toad uses the Agent Client Protocol (ACP) to communicate with AI agents. ACP is a standardized protocol—similar in concept to the Language Server Protocol (LSP)—that allows editors and interfaces to communicate with any compatible AI agent. We previously wrote about how to use OpenHands in your favorite editor through ACP.

With ACP support, Toad can act as a front-end for multiple agents. Users can switch between Claude Code, Gemini, OpenHands, and other compatible agents from within the same interface.

OpenHands in Toad

OpenHands is included as a recommended agent in Toad's agent store. When users browse available agents in Toad, they'll find OpenHands listed alongside other options, with easy installation and configuration.

The integration uses the OpenHands CLI's ACP mode. After installing OpenHands, users can launch it directly from Toad's interface:

  1. Open Toad's agent store
  2. Find OpenHands in the list of recommended agents
  3. Click "Install" to set up OpenHands via uv tool install openhands --python 3.12 && openhands login
  4. Select OpenHands and start a conversation

Toad handles the ACP communication layer, so users get the same polished terminal experience whether they're using OpenHands or any other supported agent.

Why This Partnership?

At OpenHands, we believe the future of software development should be open and community-driven. Will McGugan shares that commitment—Rich and Textual are both open source projects used by millions of developers.

Toad represents an important step toward making AI coding tools more accessible. Rather than being locked into a single vendor's interface, developers can choose the agent that best fits their needs while enjoying a consistent, high-quality terminal experience.

By sponsoring Toad's development, OpenHands is helping to build open infrastructure that benefits the entire developer community. And as a recommended agent in Toad, OpenHands becomes more accessible to developers who prefer terminal-based workflows.

Get Started

To try Toad with OpenHands, install it using uv:


uvx batrachian-toad

For more installation options and documentation, visit batrachian.ai.

From there, you can browse Toad's agent store and install OpenHands with a single click. To learn more about OpenHands, visit our documentation, try OpenHands Cloud, or join our Slack community.

Citation
OpenHands Partners with Toad: A Universal Terminal Interface for AI Agents

Get useful insights in our blog

Insights and updates from the OpenHands team

Thank you for your submission!

Oops! Something went wrong while submitting the form.
Building the open standard for autonomous software development.

OpenHands is the foundation for secure, transparent, model-agnostic coding agents - empowering every software team to build faster with full control.

Build with SDK
Try it live
© 2025 OpenHands - All rights reserved