Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

Streams events for an agent as they arrive. Each event prints on its own line with a timestamp. The stream stays open until you cancel it or the agent completes. On transient connection errors, murmur watch reconnects automatically and resumes from the last received event — no events are missed.

​
Synopsis

murmur watch [flags] [slug]
On a VM, the slug is optional — omitting it watches the current agent’s own events.

​
Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--fromstringnoResume from a specific stream entry ID. Default: "0" (all events).
--jsonboolnoOutput raw JSON, one event per line. Default: false.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

By default, each event prints as a human-readable line prefixed with a timestamp: 
[2026-05-14T18:30:12Z] PR comment from @alice (comment ID 12345):
Fix the nil check on line 42.
With --json, each event prints as a single JSON object per line — one field per event type. Useful for piping into jq or other tooling.

​
Event types

TypeWhat prints
pr_commentPR comment body, author, file path and line (if inline), and resolution instructions.
pr_reviewReview body, author, and state (approved, changes requested, commented).
ci_resultCI conclusion (success/failure), check name, commit SHA, and failing jobs.
file_changedList of conflicting files and conflict resolution instructions.
notifyThe free-text message.
child_lifecycleChild agent slug and new state (running, task-complete, failed).
pr_lifecyclePR action (opened, closed, merged, reopened) with title and URL.
pr_labeledPR number, labels, title, and URL.
issue_openedIssue number, repo, and body.
pr_openedBranch, repo, and body.
progressAgent progress text.

​
Examples

​
Watch a running agent

murmur watch fix-auth

[2026-05-14T18:30:12Z] PR comment from @alice (comment ID 12345):
Fix the nil check on line 42.

Address this comment on main.go:42.
[2026-05-14T18:31:05Z] CI result: failure (test-suite) for agent fix-auth — PR: https://github.com/acme/backend/pull/42
Commit: a1b2c3d
Failed jobs: unit-tests
Run: https://github.com/acme/backend/actions/runs/123456
Events stream in real time. Press Ctrl-C to stop.

​
JSON output for scripting

murmur watch fix-auth --json

{"event":{"prComment":{"author":"alice","body":"Fix the nil check on line 42.","path":"main.go","line":42,"commentId":"12345"}}}
Each line is a standalone JSON object.

​
Resume from a specific point

murmur watch fix-auth --from 1715710212000-0
Starts streaming from the given entry ID. Use this to resume a watch session without replaying earlier events.

​
Self-watch on a VM

When running on an agent VM, omit the slug to watch the current agent’s own events: 
murmur watch

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug. Use murmur ls to list running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.