Coordinate multiple AI coding agents running in WezTerm with real-time observation and automation.
What Is WA?
WezTerm Automata (WA) is a terminal hypervisor that captures pane output in real-time, detects agent state transitions through pattern matching, and enables event-driven automation.
When running multiple AI agents, you need to know when they hit rate limits, complete tasks, or need approval. WA observes all panes with sub-50ms latency and can trigger automated responses.
Real-time Observation
Sub-50ms pane monitoring
Pattern Detection
Recognizes agent state changes
Full-Text Search
FTS5 with BM25 ranking
Safety Engine
Capability gates & audit trails
How It Works
WA runs as a daemon that observes all WezTerm panes, detects patterns, and exposes a Robot Mode API for agent integration.
# WA observes terminal panesAgent types: "Thinking..."↓# Pattern detection engine↓Agent completes: "Done!"↓# Event triggers automation↓WA notifies other agents via mail
Quick Start
Get started with these essential commands.
Robot Mode API
Robot Mode provides a JSON API for machine-to-machine communication.
# Example: Wait for agent completionwa robot wait-for 42 "Task complete"# Then trigger next actionwa robot send 43 "Start next task"
Pattern Detection
WA detects state transitions for common AI agents.
Rate limits, approvals, completions
Task completion, errors, waiting
Response completion, quota warnings
Define your own detection rules
Tool Integration
WA integrates seamlessly with other flywheel tools.
WA + NTM
WA automatically observes agents spawned by NTM. Use NTM to spawn agents and WA to monitor their state.
WA + Agent Mail
State changes detected by WA can trigger Agent Mail notifications. Coordinate agent handoffs through mail threads.
WA + Beads
When WA detects task completion, it can update bead status. Track agent progress through your issue tracker.
Diagnostics
Troubleshoot issues with built-in diagnostics.
wa doctor if pattern detection isn't working. It checks WezTerm connectivity and daemon status.