{"id":34644807,"url":"https://github.com/batrachianai/toad","last_synced_at":"2026-05-17T12:16:00.891Z","repository":{"id":329479175,"uuid":"1021621499","full_name":"batrachianai/toad","owner":"batrachianai","description":"A unified interface for AI in your terminal.","archived":false,"fork":false,"pushed_at":"2026-01-16T17:55:26.000Z","size":2857,"stargazers_count":1733,"open_issues_count":4,"forks_count":72,"subscribers_count":15,"default_branch":"main","last_synced_at":"2026-01-18T00:20:39.501Z","etag":null,"topics":["agents-ui","ai","textual","tui"],"latest_commit_sha":null,"homepage":"https://www.batrachian.ai/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/batrachianai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"willmcgugan"}},"created_at":"2025-07-17T17:17:22.000Z","updated_at":"2026-01-17T21:32:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/batrachianai/toad","commit_stats":null,"previous_names":["batrachianai/toad"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/batrachianai/toad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batrachianai%2Ftoad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batrachianai%2Ftoad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batrachianai%2Ftoad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batrachianai%2Ftoad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/batrachianai","download_url":"https://codeload.github.com/batrachianai/toad/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batrachianai%2Ftoad/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28635123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T14:50:40.221Z","status":"ssl_error","status_checked_at":"2026-01-21T14:48:59.225Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents-ui","ai","textual","tui"],"created_at":"2025-12-24T17:37:31.734Z","updated_at":"2026-05-17T12:16:00.877Z","avatar_url":"https://github.com/batrachianai.png","language":"Python","funding_links":["https://github.com/sponsors/willmcgugan"],"categories":["Kimi CLI Related Projects","Python","Table of Contents","Harnesses \u0026 orchestration"],"sub_categories":["Common Commands","Session managers \u0026 parallel runners"],"readme":"# Toad\r\n\r\nA unified interface for AI in your terminal ([release announcement](https://willmcgugan.github.io/toad-released/)).\r\n\r\n\u003ctable\u003e\r\n\r\n  \u003ctbody\u003e\r\n\r\n  \u003ctr\u003e\r\n    \u003ctd\u003e\u003cimg alt=\"Screenshot 2026-01-30 at 19 23 54\" src=\"https://github.com/user-attachments/assets/aca51988-359a-466d-bdd1-050dc3d678ac\" /\u003e\u003c/td\u003e \r\n    \u003ctd\u003e\u003cimg alt=\"Screenshot 2026-01-30 at 19 21 00\" src=\"https://github.com/user-attachments/assets/b9b0a6bb-e084-4976-86c2-cccdb42041ae\" /\u003e\u003c/td\u003e    \r\n  \u003c/tr\u003e\r\n\r\n  \u003ctr\u003e\r\n    \u003ctd\u003e\u003cimg alt=\"Screenshot 2026-01-30 at 19 29 47\" src=\"https://github.com/user-attachments/assets/3fe4060f-d468-4635-b80f-03c24625c6c0\" /\u003e\u003c/td\u003e\r\n    \u003ctd\u003e\u003cimg alt=\"Screenshot 2026-01-30 at 19 30 08\" src=\"https://github.com/user-attachments/assets/03659d64-02fc-4936-a90d-e202bc4b70a1\" /\u003e\u003c/td\u003e\r\n  \u003c/tr\u003e\r\n    \r\n  \u003c/tbody\u003e\r\n  \r\n\u003c/table\u003e\r\n\r\n## Quickstart\r\n\r\nInstall:\r\n\r\n```\r\ncurl -fsSL batrachian.ai/install | sh\r\n```\r\n\r\nRun:\r\n\r\n```\r\ntoad\r\n```\r\n\r\nSee [Getting Started](#getting-started) if you have any problems.\r\n\r\n## What is Toad?\r\n\r\nToad is an interface to coding agents, such as Claude, Gemini, Codex, OpenHand, and many more. \r\n\r\nToad blends a traditional shell based workflow and powerful agentic AI, with an intuitive Terminal User Interface.\r\n\r\n\u003ctable\u003e\r\n  \u003ctbody\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eAI \"App store\"\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Find, install, and run dozens of agents directly from the Toad UI.\r\n        \u003cp\u003e\r\n        There is a large and growing list of AI agents that work with Toad.\r\n        Discover agents from big tech and smaller Open Source projects.\r\n        \u003cp\u003e\r\n        Developers can add support for their own agents, via the \u003ca href=\"https://agentclientprotocol.com/overview/introduction\"\u003eAgent Client Protocol\u003c/a\u003e.\r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg alt=\"Screenshot 2026-01-27 at 12 48 30\" src=\"https://github.com/user-attachments/assets/f7bd3776-6405-47e5-9d1f-11a12a4ce3b2\" /\u003e\r\n      \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n      \u003ch3\u003eToad Shell\u003c/h3\u003e\r\n      \u003cp\u003e\r\n      While most terminal agent interfaces can run commands (with the \u003ckbd\u003e!\u003c/kbd\u003e syntax), they aren't running a shell.\r\n      If you change directory or set environment variables, they won't persist from one command to the next.\r\n      \u003cp\u003e\r\n      Output that contains more than simple text will typically be garbled, and anything interactive will fail or even break the TUI entirely.\r\n      \u003cp\u003e\r\n      Toad integrates a fully working shell with full-color output, interactive commands, and tab completion.\r\n      Allowing you to interleave prompts for the agent with terminal workflows.\r\n      \u003cp\u003e\r\n      At time of writing Toad is the only terminal UI which does this.\r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\u003cimg src=\"https://github.com/user-attachments/assets/ac9247bb-3daa-4bb7-b3fd-e0bbd22475fa\"/\u003e\u003c/td\u003e        \r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003ePrompt Editor\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Toad has a nice Markdown prompt editor, with syntax highlighting for code fences.\r\n        Full mouse support, cut and paste, many keybindings and shortcuts.\r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg src=\"https://github.com/user-attachments/assets/3d619b94-ec53-4e7a-b905-5aef6f4fa8a6\"/\u003e\r\n      \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eFile Picker\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Add a file to your prompt with \u003ckbd\u003e@\u003c/kbd\u003e, and toad will show a fuzzy file picker.\r\n        \u003cp\u003e\r\n        Type a few characters from the filename or folder and Toad will refine the search as you type.\r\n        Hit \u003ckbd\u003eenter\u003c/kbd\u003e to add the file to the prompt.\r\n        \u003cp\u003e\r\n        The fuzzy picker is great when you know the file you want to mention.\r\n        If you want to explore your files, you can press \u003ckbd\u003etab\u003c/kbd\u003e to switch to an interactive tree control.                \r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg src=\"https://github.com/user-attachments/assets/ab25c389-1d2f-4006-a1d8-159edbd3ed00\"/\u003e        \r\n      \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eBeautiful Diffs\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Side-by-side or unified diffs, with syntax highlighting for most languages.      \r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg alt=\"Screenshot 2026-01-27 at 12 44 22\" src=\"https://github.com/user-attachments/assets/b3d6c29c-d6ec-4253-a9dc-2df0ff21e293\" /\u003e\r\n      \u003c/td\u003e      \r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eElegant Markdown\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Markdown is the language of LLMs (AI).\r\n        Toad's streaming Markdown support can display syntax highlighted code fences, elegant tables, quotes, lists, and more.\r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg src=\"https://github.com/user-attachments/assets/b650b407-f4ab-4cb9-8920-55c15073598e\"/\u003e\r\n      \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eSimple Settings\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        An intuitive settings system (no need to manually edit JSON files).\r\n        \u003cp\u003e\r\n        Tune Toad to your liking.\r\n        Almost everything in Toad may be tweaked.\r\n        If you want to create an ultra-minimal UI with nothing more than a prompt—you can!                \r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg src=\"https://github.com/user-attachments/assets/2ff0de12-c2e1-455b-954a-21e66c070dd8\"/\u003e      \r\n      \u003c/td\u003e    \r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eConcurrent sessions\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Launch and run multiple agents from potentially different providers.\r\n        \u003cp\u003e\r\n        Hit \u003ckbd\u003ectrl+s\u003c/kbd\u003e to show the current state of all your agents in one screen.\r\n        \u003c/p\u003e        \r\n      \u003c/td\u003e \r\n      \u003ctd\u003e\r\n        \u003cimg  alt=\"Screenshot 2026-02-16 at 17 33 40-fs8\" src=\"https://github.com/user-attachments/assets/cd3128eb-b348-4f40-b5c0-4816d07dcbe9\" /\u003e\r\n      \u003c/td\u003e    \r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e\r\n        \u003ch3\u003eSession Resume\u003c/h3\u003e\r\n        \u003cp\u003e\r\n        Resume previous sessions with your agent.    \r\n        \u003cp\u003e\r\n        Hit \u003ckbd\u003ectrl+r\u003c/kbd\u003e to pick a previous session to resume.\r\n      \u003c/td\u003e\r\n      \u003ctd\u003e\r\n        \u003cimg alt=\"Screenshot 2026-02-01 at 16 57 46\" src=\"https://github.com/user-attachments/assets/7c1ad59e-027c-4542-a216-9a32ef573936\" /\u003e\r\n      \u003c/td\u003e    \r\n    \u003c/tr\u003e    \r\n  \u003c/tbody\u003e\r\n\u003c/table\u003e\r\n\r\n## Video\r\n\r\nWatch a preview of the Toad User Interface:\r\n\r\nhttps://github.com/user-attachments/assets/ced36f4b-db02-4d29-8a0a-14ec64b22881\r\n\r\n\r\n## Compatibility\r\n\r\nToad runs on Linux and macOS. Native Windows support is currently lacking (but on the roadmap), but Toad will run quite well with WSL.\r\n\r\nToad is a terminal application.\r\nAny terminal will work, although if you are using the default terminal on macOS you will get a much reduced experience.\r\nI recommend [Ghostty](https://ghostty.org/) which is fully featured and has amazing performance.\r\n\r\n### Clipboard\r\n\r\nOn Linux, you may need to install `xclip` to enable clipboard support.\r\n\r\n```\r\nsudo apt install xclip\r\n```\r\n\r\n## Getting Started\r\n\r\nThe easiest way to install Toad is by pasting the following in to your terminal:\r\n\r\n```bash\r\ncurl -fsSL batrachian.ai/install | sh\r\n```\r\n\r\nYou should now have `toad` installed.\r\n\r\nIf that doesn't work for any reason, then you can install with the following steps:\r\n\r\nFirst [install UV](https://docs.astral.sh/uv/getting-started/installation/):\r\n\r\n```bash\r\ncurl -LsSf https://astral.sh/uv/install.sh | sh\r\n```\r\n\r\nThen use UV to install toad:\r\n\r\n```bash\r\nuv tool install -U batrachian-toad --python 3.14\r\n```\r\n\r\nToad is also available on [conda-forge](https://conda-forge.org), and can be installed using [pixi](https://pixi.prefix.dev/latest/#installation):\r\n\r\n```bash\r\npixi global install batrachian-toad\r\n```\r\n\r\n## Using Toad\r\n\r\nLaunch Toad with the following:\r\n\r\n```bash\r\ntoad\r\n```\r\n\r\nYou should see something like this:\r\n\r\n\u003cimg alt=\"front-fs8\" src=\"https://github.com/user-attachments/assets/8831f7de-5349-4b3f-9de9-d4565b513108\" /\u003e\r\n\r\nFrom this screen you will be able to find, install, and launch a coding agent.\r\nIf you already have an agent installed, you can skip the install step.\r\nTo launch an agent, select it and press \u003ckbd\u003espace\u003c/kbd\u003e.\r\n\r\nThe footer will always display the most significant keys for the current context.\r\nTo see all the keys, press \u003ckbd\u003eF1\u003c/kbd\u003e to display the help panel.\r\n\r\n### Toad CLI\r\n\r\nWhen running Toad, the current working directory is assumed to be your project directory.\r\nTo use another project directory, add the path to the command.\r\nFor example:\r\n\r\n```bash\r\ntoad ~/projects/my-awesome-app\r\n```\r\n\r\nIf you want to skip the initial agent screen, add the `-a` switch with the name of your chosen agent.\r\nFor example:\r\n\r\n```bash\r\ntoad -a open-hands\r\n```\r\n\r\nTo see all subcommands and switches, add the `--help` switch:\r\n\r\n```bash\r\ntoad --help\r\n```\r\n\r\n### Web server\r\n\r\nYou can run Toad as a web application.\r\n\r\nRun the following, and click the link in the terminal:\r\n\r\n```bash\r\ntoad serve\r\n```\r\n\r\n![textual-serve](https://github.com/user-attachments/assets/1d861d48-d30b-44cd-972d-5986a01360bf)\r\n\r\n## Toad development\r\n\r\nToad was built by [Will McGugan](https://github.com/willmcgugan) and is currently under active development.\r\n\r\nTo discuss Toad, see the Discussions tab, or join the #toad channel on the [Textualize discord server](https://discord.gg/Enf6Z3qhVr).\r\n\r\n\r\n\r\n### Roadmap\r\n\r\nSome planned features:\r\n\r\n- [ ] UI for MCP servers\r\n- [ ] Expose model selection (waiting on ACP update)\r\n- [x] Sessions (resume)\r\n- [x] Multiple agents\r\n- [ ] Windows native support\r\n- [ ] Builtin editor\r\n- [ ] Sidebar (widgets)\r\n  - [ ] Git pending changes\r\n\r\n### Reporting bugs\r\n\r\nThis project is trialling a non-traditional approach to issues.\r\nBefore an issue is created, there must be a post in Discussions, approved by a Toad dev (Currently @willmcgugan).\r\n\r\nBy allowing the discussions to happen in the Discussion tabs, issues can be reserved for actionable tasks with a clear description and goal.\r\n\r\n\r\n## Licensing\r\n\r\nToad is licensed under the [AGPL](./LICENSE) license. Commercial licenses are available. See [COMMERCIAL_LICENSE.md](./COMMERCIAL_LICENSE.md).\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbatrachianai%2Ftoad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbatrachianai%2Ftoad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbatrachianai%2Ftoad/lists"}