[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72358":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},72358,"toad","batrachianai\u002Ftoad","batrachianai","A unified interface for AI in your terminal.","https:\u002F\u002Fwww.batrachian.ai\u002F",null,"Python",3201,151,24,3,0,11,31,149,33,104.05,"GNU Affero General Public License v3.0",false,"main",true,[27,28,29,30,31,32,33,34,35],"agents-ui","ai","claude","claude-code","codex-cli","commercial-license","copilot","textual","tui","2026-06-12 04:01:04","# Toad\r\n\r\nA unified interface for AI in your terminal ([release announcement](https:\u002F\u002Fwillmcgugan.github.io\u002Ftoad-released\u002F)).\r\n\r\n\u003Ctable>\r\n\r\n  \u003Ctbody>\r\n\r\n  \u003Ctr>\r\n    \u003Ctd>\u003Cimg alt=\"Screenshot 2026-01-30 at 19 23 54\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Faca51988-359a-466d-bdd1-050dc3d678ac\" \u002F>\u003C\u002Ftd> \r\n    \u003Ctd>\u003Cimg alt=\"Screenshot 2026-01-30 at 19 21 00\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb9b0a6bb-e084-4976-86c2-cccdb42041ae\" \u002F>\u003C\u002Ftd>    \r\n  \u003C\u002Ftr>\r\n\r\n  \u003Ctr>\r\n    \u003Ctd>\u003Cimg alt=\"Screenshot 2026-01-30 at 19 29 47\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3fe4060f-d468-4635-b80f-03c24625c6c0\" \u002F>\u003C\u002Ftd>\r\n    \u003Ctd>\u003Cimg alt=\"Screenshot 2026-01-30 at 19 30 08\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F03659d64-02fc-4936-a90d-e202bc4b70a1\" \u002F>\u003C\u002Ftd>\r\n  \u003C\u002Ftr>\r\n    \r\n  \u003C\u002Ftbody>\r\n  \r\n\u003C\u002Ftable>\r\n\r\n## Quickstart\r\n\r\nInstall:\r\n\r\n```\r\ncurl -fsSL batrachian.ai\u002Finstall | 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>\r\n  \u003Ctbody>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>AI \"App store\"\u003C\u002Fh3>\r\n        \u003Cp>\r\n        Find, install, and run dozens of agents directly from the Toad UI.\r\n        \u003Cp>\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>\r\n        Developers can add support for their own agents, via the \u003Ca href=\"https:\u002F\u002Fagentclientprotocol.com\u002Foverview\u002Fintroduction\">Agent Client Protocol\u003C\u002Fa>.\r\n      \u003C\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg alt=\"Screenshot 2026-01-27 at 12 48 30\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ff7bd3776-6405-47e5-9d1f-11a12a4ce3b2\" \u002F>\r\n      \u003C\u002Ftd>\r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n      \u003Ch3>Toad Shell\u003C\u002Fh3>\r\n      \u003Cp>\r\n      While most terminal agent interfaces can run commands (with the \u003Ckbd>!\u003C\u002Fkbd> 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>\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>\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>\r\n      At time of writing Toad is the only terminal UI which does this.\r\n      \u003C\u002Ftd>\r\n      \u003Ctd>\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fac9247bb-3daa-4bb7-b3fd-e0bbd22475fa\"\u002F>\u003C\u002Ftd>        \r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>Prompt Editor\u003C\u002Fh3>\r\n        \u003Cp>\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\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3d619b94-ec53-4e7a-b905-5aef6f4fa8a6\"\u002F>\r\n      \u003C\u002Ftd>\r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>File Picker\u003C\u002Fh3>\r\n        \u003Cp>\r\n        Add a file to your prompt with \u003Ckbd>@\u003C\u002Fkbd>, and toad will show a fuzzy file picker.\r\n        \u003Cp>\r\n        Type a few characters from the filename or folder and Toad will refine the search as you type.\r\n        Hit \u003Ckbd>enter\u003C\u002Fkbd> to add the file to the prompt.\r\n        \u003Cp>\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>tab\u003C\u002Fkbd> to switch to an interactive tree control.                \r\n      \u003C\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fab25c389-1d2f-4006-a1d8-159edbd3ed00\"\u002F>        \r\n      \u003C\u002Ftd>\r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>Beautiful Diffs\u003C\u002Fh3>\r\n        \u003Cp>\r\n        Side-by-side or unified diffs, with syntax highlighting for most languages.      \r\n      \u003C\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg alt=\"Screenshot 2026-01-27 at 12 44 22\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb3d6c29c-d6ec-4253-a9dc-2df0ff21e293\" \u002F>\r\n      \u003C\u002Ftd>      \r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>Elegant Markdown\u003C\u002Fh3>\r\n        \u003Cp>\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\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb650b407-f4ab-4cb9-8920-55c15073598e\"\u002F>\r\n      \u003C\u002Ftd>\r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>Simple Settings\u003C\u002Fh3>\r\n        \u003Cp>\r\n        An intuitive settings system (no need to manually edit JSON files).\r\n        \u003Cp>\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\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F2ff0de12-c2e1-455b-954a-21e66c070dd8\"\u002F>      \r\n      \u003C\u002Ftd>    \r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>Concurrent sessions\u003C\u002Fh3>\r\n        \u003Cp>\r\n        Launch and run multiple agents from potentially different providers.\r\n        \u003Cp>\r\n        Hit \u003Ckbd>ctrl+s\u003C\u002Fkbd> to show the current state of all your agents in one screen.\r\n        \u003C\u002Fp>        \r\n      \u003C\u002Ftd> \r\n      \u003Ctd>\r\n        \u003Cimg  alt=\"Screenshot 2026-02-16 at 17 33 40-fs8\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fcd3128eb-b348-4f40-b5c0-4816d07dcbe9\" \u002F>\r\n      \u003C\u002Ftd>    \r\n    \u003C\u002Ftr>\r\n    \u003Ctr>\r\n      \u003Ctd>\r\n        \u003Ch3>Session Resume\u003C\u002Fh3>\r\n        \u003Cp>\r\n        Resume previous sessions with your agent.    \r\n        \u003Cp>\r\n        Hit \u003Ckbd>ctrl+r\u003C\u002Fkbd> to pick a previous session to resume.\r\n      \u003C\u002Ftd>\r\n      \u003Ctd>\r\n        \u003Cimg alt=\"Screenshot 2026-02-01 at 16 57 46\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7c1ad59e-027c-4542-a216-9a32ef573936\" \u002F>\r\n      \u003C\u002Ftd>    \r\n    \u003C\u002Ftr>    \r\n  \u003C\u002Ftbody>\r\n\u003C\u002Ftable>\r\n\r\n## Video\r\n\r\nWatch a preview of the Toad User Interface:\r\n\r\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fced36f4b-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:\u002F\u002Fghostty.org\u002F) 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\u002Finstall | 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:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F):\r\n\r\n```bash\r\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.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:\u002F\u002Fconda-forge.org), and can be installed using [pixi](https:\u002F\u002Fpixi.prefix.dev\u002Flatest\u002F#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:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F8831f7de-5349-4b3f-9de9-d4565b513108\" \u002F>\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>space\u003C\u002Fkbd>.\r\n\r\nThe footer will always display the most significant keys for the current context.\r\nTo see all the keys, press \u003Ckbd>F1\u003C\u002Fkbd> 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 ~\u002Fprojects\u002Fmy-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:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1d861d48-d30b-44cd-972d-5986a01360bf)\r\n\r\n## Toad development\r\n\r\nToad was built by [Will McGugan](https:\u002F\u002Fgithub.com\u002Fwillmcgugan) 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:\u002F\u002Fdiscord.gg\u002FEnf6Z3qhVr).\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](.\u002FLICENSE) license. Commercial licenses are available. See [COMMERCIAL_LICENSE.md](.\u002FCOMMERCIAL_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","Toad 是一个统一的终端AI接口，支持多种编码代理如Claude、Gemini、Codex等。其核心功能包括集成全功能Shell环境，支持彩色输出、交互命令和自动补全，同时提供直观的终端用户界面（TUI），并内置了一个带有语法高亮的Markdown提示编辑器。此外，Toad还具备一个AI“应用商店”，用户可以发现、安装并运行来自大型科技公司及开源项目的众多代理程序。开发者也可以通过Agent Client Protocol为自己的代理添加支持。该工具非常适合需要在命令行环境中高效利用AI能力进行开发或自动化任务处理的场景。",2,"2026-06-11 03:41:30","high_star"]