Debug Your Agents
View traces, tail live events, and debug Google ADK agent behavior without leaving your terminal.
pip install watchtower-adkTerminal-First
Three commands. Full observability. No context switching.
watchtower show
Inspect any trace with full detail. Drill down into LLM calls, tool invocations, and state changes.
$ watchtower show abc123watchtower tail
Stream events in real-time as your agent runs. Watch LLM requests, tool calls, and state changes live.
$ watchtower tail agent.pywatchtower list
Browse all saved traces. Filter by agent, date, or status. Jump into any trace with one keystroke.
$ watchtower list --limit 20See Everything
Watch your agent think in real-time. Every LLM call, every tool invocation, every state change.
How It Works
Get from zero to full observability in under a minute.
Install the SDK
Add watchtower-adk to your Python project. One import, zero configuration.
$ pip install watchtower-adkInstrument Your Agent
Import the plugin and add it to your ADK agent. Tracing starts automatically.
$ from watchtower import WatchtowerPluginRun Your Agent
Execute your agent normally. Watchtower captures every event to disk.
$ python my_agent.pyExplore Traces
Use the CLI to view, search, and analyze your agent traces.
$ watchtower listStart Debugging
Install the SDK and get full observability for your Google ADK agents in seconds.
pip install watchtower-adk