watch

Returns a ready-to-run agnt monitor command string for streaming daemon events to your terminal in real time. MCP clients know the daemon socket path; this tool bridges them to the agnt monitor CLI so you can tail errors, interactions, or process output live.

watch does not stream events itself — it hands you the exact command to run.

Synopsis

watch {}
watch {target: "errors", proxy_id: "dev"}
watch {target: "process", process_id: "app"}

Parameters

Parameter	Type	Required	Default	Description
target	string	No	all	What to watch: errors, interactions, process, all
proxy_id	string	No	none	Filter to a specific proxy
process_id	string	No	none	Filter to a specific process (required for target: "process")

Targets

Target	Streams	Required params
errors	Error and diagnostic events	optional proxy_id
interactions	User interactions — panel messages, clicks, sketch, design	optional proxy_id
process	A process's output stream (follow mode)	process_id
all	All daemon events (default)	none

Output

Returns a command string and a human-readable description:

{
  "command": "agnt monitor --socket /tmp/devtool-mcp-1000.sock --types error,diagnostic --format compact",
  "description": "Stream error and diagnostic events from all proxies"
}

Run the command in a terminal to start the live stream.

The agnt monitor CLI

agnt monitor                           # All events
agnt monitor --types error,diagnostic  # Errors only
agnt monitor --proxy dev --format json # NDJSON for a specific proxy
agnt monitor --process app             # Process output, follow mode

Flags: --types, --proxy, --process, --severity, --format (compact/json), --socket. The stream auto-reconnects on daemon restart and exits cleanly on SIGINT/SIGTERM.

See Also

• get_errors — pull-based error snapshot (vs this push stream)
• proxylog — query the historical traffic log
• proc — process management