Skip to main content
Watch messages and replies for a saved agent in a terminal.

​
Before you start

  • Use Node.js 22.22.3 or newer.
  • Use an interactive terminal when a command asks for input.

​
Open the live view

Save an agent with Connect or authentication first. Keep its runtime running.
You can pass a saved handle as the optional argument. The view only watches; the runtime still receives events. Press q to leave. Watch needs a terminal.
--profile selects the profile. A script, pipe, or --json returns without the live view. Press Ctrl-C to leave. The read-only view uses observe=true and requires observational: true. It sends neither ACKs nor full_sync_complete; your runtime remains the consumer. Connect a runtime · Observe events

​
What you get back

Captured with relaymessenger. Help output describes the command; it does not prove a live reply.
captured-output
Generated watch reference

​
When it fails

Use the exit-code table to distinguish input, missing resources, and authentication failures. Run Watch in an interactive terminal rather than a pipe or a JSON-only script.

​
Next steps