batrachian-toad 0.5.0a8__tar.gz → 0.5.8__tar.gz

batrachian_toad-0.5.8/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.5.8] - 2025-12-26
+
+### Fixed
+
+- Fixed broken tool calls
+
+## [0.5.7] - 2025-12-26
+
+### Changes
+
+- Cursor keys can navigate between sections in the store screen
+- Optimized path search
+- Disabled path search in shell mode
+- Typing in the conversation view will auto-focus the prompt
+
+### Added
+
+- Added single character switches https://github.com/batrachianai/toad/pull/135
+
+## [0.5.6] - 2025-12-24
+
+### Fixed
+
+- Fixed agent selector not focusing on run.
+- Added project directory as second argument to `toad acp` rather than a switch.
+
+## [0.5.5] - 2025-12-22
+
+### Fixed
+
+- Fixed column setting not taking effect
+
+## [0.5.0] - 2025-12-18
+
+### Added
+
+- First release. This document will be updated for subsequent releases.
+
+[0.5.8]: https://github.com/Textualize/textual/compare/v0.5.7...v0.5.8
+[0.5.7]: https://github.com/Textualize/textual/compare/v0.5.6...v0.5.7
+[0.5.6]: https://github.com/Textualize/textual/compare/v0.5.5...v0.5.6
+[0.5.5]: https://github.com/Textualize/textual/compare/v0.5.0...v0.5.5
+[0.5.0]: https://github.com/batrachianai/toad/releases/tag/v0.5.0

batrachian_toad-0.5.8/CONTRIBUTING.md

@@ -0,0 +1,8 @@
+# Guide to Contributing
+
+Thank you for your interesting in improving Toad!
+
+If you are thinking of fixing a bug or contributing a feature, please open a Discussion first.
+You will be asked for a link to the discussion when you contribute a PR.
+
+TODO: add technical help

batrachian_toad-0.5.8/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: batrachian-toad
+Version: 0.5.8
+Summary: A unified experience for AI in your terminal.
+License-File: LICENSE
+Requires-Python: >=3.14
+Requires-Dist: bashlex>=0.18
+Requires-Dist: click>=8.2.1
+Requires-Dist: gitpython>=3.1.44
+Requires-Dist: google-re2>=1.1.20251105
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: packaging>=25.0
+Requires-Dist: pathspec>=0.12.1
+Requires-Dist: platformdirs>=4.3.8
+Requires-Dist: rich
+Requires-Dist: textual-serve>=1.1.2
+Requires-Dist: textual-speedups==0.2.1
+Requires-Dist: textual[syntax]>=6.11.0
+Requires-Dist: tree-sitter>=0.24.0
+Requires-Dist: typeguard>=4.4.4
+Requires-Dist: xdg-base-dirs>=6.0.2
+Description-Content-Type: text/markdown
+
+# Toad
+
+A unified interface for AI in your terminal ([release announcement](https://willmcgugan.github.io/toad-released/)).
+
+Run coding agents seamlessly under a single beautiful terminal UI, thanks to the [ACP](https://agentclientprotocol.com/protocol/initialization) protocol.
+
+<table>
+
+  <tbody>
+
+  <tr>
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 58 58" src="https://github.com/user-attachments/assets/98387559-2e10-485a-8a7d-82cb00ed7622" /></td> 
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 59 04" src="https://github.com/user-attachments/assets/d4231320-b678-47ba-99ce-02746ca2622b" /></td>    
+  </tr>
+
+  <tr>
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 59 22" src="https://github.com/user-attachments/assets/ddba550d-ff33-45ad-9f93-281187f5c974" /></td>
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 59 37" src="https://github.com/user-attachments/assets/e7943272-39a5-40a1-bedf-e440002e1290" /></td>
+  </tr>
+    
+  </tbody>
+
+  
+</table>
+
+## Compatibility
+
+Toad runs on Linux and macOS. Native Windows support is currently lacking (but on the roadmap), but Toad will run quite well with WSL.
+
+Toad is a terminal application.
+Any terminal will work, although if you are using the default terminal on macOS you will get a much reduced experience.
+I recommend [Ghostty](https://ghostty.org/) which is fully featured and has amazing performance.
+
+
+## Getting Started
+
+The easiest way to install Toad is by pasting the following in to your terminal:
+
+```bash
+curl -fsSL batrachian.ai/install | sh
+```
+
+You should now have `toad` installed.
+
+If that doesn't work for any reason, then you can install with the following steps:
+
+First [install UV](https://docs.astral.sh/uv/getting-started/installation/):
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Then use UV to install toad:
+
+```bash
+uv tool install -U batrachian-toad --python 3.14
+```
+
+## Using Toad
+
+Launch Toad with the following:
+
+```bash
+toad
+```
+
+You should see something like this:
+
+<img width="1266" height="994" alt="front-fs8" src="https://github.com/user-attachments/assets/8831f7de-5349-4b3f-9de9-d4565b513108" />
+
+From this screen you will be able to find, install, and launch a coding agent.
+If you already have an agent installed, you can skip the install step.
+To launch an agent, select it and press space.
+
+The footer will always display the most significant keys for the current context.
+To see all the keys, summon the command palette with `ctrl+p` and search for "keys".
+
+### Toad CLI
+
+When running Toad, the current working directory is assumed to be your project directory.
+To use another project directory, add the path to the command.
+For example:
+
+```bash
+toad ~/projects/my-awesome-app
+```
+
+If you want to skip the initial agent screen, add the `-a` switch with the name of your chosen agent.
+For example:
+
+```bash
+toad -a open-hands
+```
+
+To see all subcommands and switches, add the `--help` switch:
+
+```bash
+toad --help
+```
+
+### Web server
+
+You can run Toad as a web application.
+
+Run the following, and click the link in the terminal:
+
+```bash
+toad serve
+```
+
+![textual-serve](https://github.com/user-attachments/assets/1d861d48-d30b-44cd-972d-5986a01360bf)
+
+## Toad development
+
+Toad was built by [Will McGugan](https://github.com/willmcgugan) and is currently under active development.
+
+To discuss Toad, see the Discussions tab, or join the #toad channel on the [Textualize discord server](https://discord.gg/Enf6Z3qhVr).
+
+### Roadmap
+
+Some planned features:
+
+- UI for MCP servers
+- Expose model selection (waiting on ACP update)
+- Sessions
+- Multiple agents
+- Windows native support
+
+### Reporting bugs
+
+This project is trialling a non-traditional approach to issues.
+Before an issue is created, there must be a post in Dicussions, approved by a Toad dev (Currently @willmcgugan).
+
+By allowing the discussions to happen in the Discussion tabs, issues can be reserved for actionable tasks with a clear description and goal.
+
+
+
+
+
+
+
+
+
+

batrachian_toad-0.5.8/README.md

@@ -0,0 +1,144 @@
+# Toad
+
+A unified interface for AI in your terminal ([release announcement](https://willmcgugan.github.io/toad-released/)).
+
+Run coding agents seamlessly under a single beautiful terminal UI, thanks to the [ACP](https://agentclientprotocol.com/protocol/initialization) protocol.
+
+<table>
+
+  <tbody>
+
+  <tr>
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 58 58" src="https://github.com/user-attachments/assets/98387559-2e10-485a-8a7d-82cb00ed7622" /></td> 
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 59 04" src="https://github.com/user-attachments/assets/d4231320-b678-47ba-99ce-02746ca2622b" /></td>    
+  </tr>
+
+  <tr>
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 59 22" src="https://github.com/user-attachments/assets/ddba550d-ff33-45ad-9f93-281187f5c974" /></td>
+    <td><img width="1338" height="1004" alt="Screenshot 2025-10-23 at 08 59 37" src="https://github.com/user-attachments/assets/e7943272-39a5-40a1-bedf-e440002e1290" /></td>
+  </tr>
+    
+  </tbody>
+
+  
+</table>
+
+## Compatibility
+
+Toad runs on Linux and macOS. Native Windows support is currently lacking (but on the roadmap), but Toad will run quite well with WSL.
+
+Toad is a terminal application.
+Any terminal will work, although if you are using the default terminal on macOS you will get a much reduced experience.
+I recommend [Ghostty](https://ghostty.org/) which is fully featured and has amazing performance.
+
+
+## Getting Started
+
+The easiest way to install Toad is by pasting the following in to your terminal:
+
+```bash
+curl -fsSL batrachian.ai/install | sh
+```
+
+You should now have `toad` installed.
+
+If that doesn't work for any reason, then you can install with the following steps:
+
+First [install UV](https://docs.astral.sh/uv/getting-started/installation/):
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Then use UV to install toad:
+
+```bash
+uv tool install -U batrachian-toad --python 3.14
+```
+
+## Using Toad
+
+Launch Toad with the following:
+
+```bash
+toad
+```
+
+You should see something like this:
+
+<img width="1266" height="994" alt="front-fs8" src="https://github.com/user-attachments/assets/8831f7de-5349-4b3f-9de9-d4565b513108" />
+
+From this screen you will be able to find, install, and launch a coding agent.
+If you already have an agent installed, you can skip the install step.
+To launch an agent, select it and press space.
+
+The footer will always display the most significant keys for the current context.
+To see all the keys, summon the command palette with `ctrl+p` and search for "keys".
+
+### Toad CLI
+
+When running Toad, the current working directory is assumed to be your project directory.
+To use another project directory, add the path to the command.
+For example:
+
+```bash
+toad ~/projects/my-awesome-app
+```
+
+If you want to skip the initial agent screen, add the `-a` switch with the name of your chosen agent.
+For example:
+
+```bash
+toad -a open-hands
+```
+
+To see all subcommands and switches, add the `--help` switch:
+
+```bash
+toad --help
+```
+
+### Web server
+
+You can run Toad as a web application.
+
+Run the following, and click the link in the terminal:
+
+```bash
+toad serve
+```
+
+![textual-serve](https://github.com/user-attachments/assets/1d861d48-d30b-44cd-972d-5986a01360bf)
+
+## Toad development
+
+Toad was built by [Will McGugan](https://github.com/willmcgugan) and is currently under active development.
+
+To discuss Toad, see the Discussions tab, or join the #toad channel on the [Textualize discord server](https://discord.gg/Enf6Z3qhVr).
+
+### Roadmap
+
+Some planned features:
+
+- UI for MCP servers
+- Expose model selection (waiting on ACP update)
+- Sessions
+- Multiple agents
+- Windows native support
+
+### Reporting bugs
+
+This project is trialling a non-traditional approach to issues.
+Before an issue is created, there must be a post in Dicussions, approved by a Toad dev (Currently @willmcgugan).
+
+By allowing the discussions to happen in the Discussion tabs, issues can be reserved for actionable tasks with a clear description and goal.
+
+
+
+
+
+
+
+
+
+

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "batrachian-toad"
-version = "0.5.0a8"
+version = "0.5.8"
 description = "A unified experience for AI in your terminal."
 readme = "README.md"
 requires-python = ">=3.14"
 dependencies = [
-    "textual[syntax]>=6.10.0",
+    "textual[syntax]>=6.11.0",
     "click>=8.2.1",
     "gitpython>=3.1.44",
     "tree-sitter>=0.24.0",
@@ -17,9 +17,9 @@ dependencies = [
     "textual-serve>=1.1.2",
     "textual-speedups==0.2.1",
     "packaging>=25.0",
-    "posthog>=7.0.1",
     "bashlex>=0.18",
     "pathspec>=0.12.1",
+    "google-re2>=1.1.20251105",
 ]
 
 [tool.uv.workspace]

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/src/toad/acp/agent.py

@@ -3,7 +3,7 @@ import asyncio
 import json
 import os
 from pathlib import Path
-from typing import cast, NamedTuple
+from typing import Any, cast, NamedTuple
 from copy import deepcopy
 
 import rich.repr
@@ -125,11 +125,22 @@ class Agent(AgentBase):
         return message_target.post_message(message)
 
     @jsonrpc.expose("session/update")
-    def rpc_session_update(self, sessionId: str, update: protocol.SessionUpdate):
+    def rpc_session_update(
+        self,
+        sessionId: str,
+        update: protocol.SessionUpdate,
+        _meta: dict[str, Any] | None = None,
+    ):
         """Agent requests an update.
 
         https://agentclientprotocol.com/protocol/schema
         """
+        status_line: str | None = None
+        if _meta and (field_meta := _meta.get("field_meta")) is not None:
+            if (
+                open_hands_metrics := field_meta.get("openhands.dev/metrics")
+            ) is not None:
+                status_line = open_hands_metrics.get("status_line")
 
         match update:
             case {
@@ -190,6 +201,9 @@ class Agent(AgentBase):
             case {"sessionUpdate": "current_mode_update", "currentModeId": mode_id}:
                 self.post_message(messages.ModeUpdate(mode_id))
 
+        if status_line is not None:
+            self.post_message(messages.UpdateStatusLine(status_line))
+
     @jsonrpc.expose("session/request_permission")
     async def rpc_request_permission(
         self,
@@ -359,7 +373,10 @@ class Agent(AgentBase):
     async def _run_agent(self) -> None:
         """Task to communicate with the agent subprocess."""
 
-        agent_output = open("agent.jsonl", "wb")
+        if constants.DEBUG:
+            agent_output = open("agent.jsonl", "wb")
+        else:
+            agent_output = None
 
         PIPE = asyncio.subprocess.PIPE
         env = os.environ.copy()
@@ -411,8 +428,9 @@ class Agent(AgentBase):
             if not line.strip():
                 continue
 
-            agent_output.write(line)
-            agent_output.flush()
+            if agent_output is not None:
+                agent_output.write(line)
+                agent_output.flush()
 
             try:
                 line_str = line.decode("utf-8")
@@ -464,7 +482,15 @@ class Agent(AgentBase):
                 )
             )
 
-        agent_output.close()
+        if agent_output is not None:
+            agent_output.close()
+
+        self._process = None
+
+    async def stop(self) -> None:
+        """Gracefully stop the process."""
+        if self._process is not None:
+            self._process.terminate()
 
     async def run(self) -> None:
         """The main logic of the Agent."""

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/src/toad/acp/messages.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 
 from asyncio import Future
-from typing import Mapping, TYPE_CHECKING
+from typing import Any, Mapping, TYPE_CHECKING
 from textual.message import Message
 
 import rich.repr
@@ -27,6 +27,11 @@ class Thinking(AgentMessage):
     text: str
 
 
+@dataclass
+class UpdateStatusLine(AgentMessage):
+    status_line: str
+
+
 @dataclass
 class Update(AgentMessage):
     type: str

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/src/toad/agent.py

@@ -57,3 +57,6 @@ class AgentBase(ABC):
 
     def get_info(self) -> Content:
         return Content("")
+
+    async def stop(self) -> None:
+        """Stop the agent (gracefully exit the process)"""

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/src/toad/ansi/_ansi.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import io
 from itertools import accumulate
-import re
+import re2 as re
 
 from dataclasses import dataclass, field
 from functools import lru_cache

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/src/toad/ansi/_stream_parser.py

@@ -1,6 +1,6 @@
 from functools import lru_cache
 import io
-import re
+import re2 as re
 
 import rich.repr
 

{batrachian_toad-0.5.0a8 → batrachian_toad-0.5.8}/src/toad/app.py

@@ -1,4 +1,5 @@
 import asyncio
+from datetime import datetime, timezone
 from functools import cached_property
 from pathlib import Path
 import json
@@ -7,15 +8,14 @@ from typing import Any, ClassVar, TYPE_CHECKING
 
 from rich import terminal_theme
 
-from textual import work
+from textual import on, work
 from textual.binding import Binding, BindingType
 from textual.reactive import var, reactive
 from textual.app import App
+from textual import events
 from textual.signal import Signal
 
 
-from posthog import Posthog
-
 from toad.settings import Schema, Settings
 from toad.agent_schema import Agent as AgentData
 from toad.settings_schema import SCHEMA
@@ -29,12 +29,6 @@ if TYPE_CHECKING:
     from toad.screens.store import StoreScreen
 
 
-import warnings
-
-# TODO: Look in to Posthog Syntax warnings
-warnings.filterwarnings("ignore", category=SyntaxWarning)
-
-
 DRACULA_TERMINAL_THEME = terminal_theme.TerminalTheme(
     background=(40, 42, 54),  # #282A36
     foreground=(248, 248, 242),  # #F8F8F2
@@ -217,6 +211,8 @@ def get_store_screen() -> StoreScreen:
 
 
 class ToadApp(App, inherit_bindings=False):
+    """The top level app."""
+
     SCREENS = {"settings": get_settings_screen}
     MODES = {"store": get_store_screen}
     BINDING_GROUP_TITLE = "System"
@@ -268,10 +264,7 @@ class ToadApp(App, inherit_bindings=False):
         )
         self._initial_mode = mode
         self.version_meta: VersionMeta | None = None
-        self.posthog = Posthog(
-            project_api_key="phc_mJWPV7GP3ar1i9vxBg2U8aiKsjNgVwum6F6ZggaD4ri",
-            host="https://us.i.posthog.com",
-        )
+
         super().__init__()
 
     @property
@@ -324,13 +317,30 @@ class ToadApp(App, inherit_bindings=False):
         if not self.settings.get("statistics.allow_collect", bool):
             # User has disabled stats
             return
+
+        POSTHOG_API_KEY = "phc_mJWPV7GP3ar1i9vxBg2U8aiKsjNgVwum6F6ZggaD4ri"
+        POSTHOG_HOST = "https://us.i.posthog.com"
+        POSTHOG_EVENT_URL = f"{POSTHOG_HOST}/i/v0/e/"
+
+        import platform
+        import httpx
+
+        timestamp = datetime.now(timezone.utc).isoformat()
+
         event_properties = {"toad_version": self.version} | properties
-        await asyncio.to_thread(
-            self.posthog.capture,
-            event_name,
-            distinct_id=self.anon_id,
-            properties=event_properties,
-        )
+        body_json = {
+            "api_key": POSTHOG_API_KEY,
+            "event": event_name,
+            "distinct_id": self.anon_id,
+            "properties": event_properties,
+            "timestamp": timestamp,
+            "os": platform.system(),
+        }
+        try:
+            async with httpx.AsyncClient() as client:
+                await client.post(POSTHOG_EVENT_URL, json=body_json)
+        except Exception:
+            pass
 
     def save_settings(self) -> None:
         if self.settings.changed:
@@ -355,8 +365,16 @@ class ToadApp(App, inherit_bindings=False):
         elif key == "ui.scrollbar":
             if isinstance(value, str):
                 self.scrollbar = value
+        elif key == "ui.compact-input":
+            self.set_class(bool(value), "-compact-input")
         elif key == "ui.footer":
             self.set_class(not bool(value), "-hide-footer")
+        elif key == "ui.status-line":
+            self.set_class(not bool(value), "-hide-status-line")
+        elif key == "ui.agent-title":
+            self.set_class(not bool(value), "-hide-agent-title")
+        elif key == "ui.info-bar":
+            self.set_class(not bool(value), "-hide-info-bar")
         elif key == "agent.thoughts":
             self.set_class(not bool(value), "-hide-thoughts")
         elif key == "sidebar.hide":
@@ -387,6 +405,16 @@ class ToadApp(App, inherit_bindings=False):
 
         self.set_timer(1, self.run_version_check)
 
+    @on(events.TextSelected)
+    async def on_text_selected(self) -> None:
+        if self.settings.get("ui.auto_copy", bool):
+            if (selection := self.screen.get_selected_text()) is not None:
+                self.copy_to_clipboard(selection)
+                self.notify(
+                    "Copied selection to clipboard (see settings)",
+                    title="Automatic copy",
+                )
+
     def run_on_exit(self):
         if self.update_required and self.version_meta is not None:
             version_meta = self.version_meta