murmur timeline

Prints an agent’s timeline: one line per lifecycle entry, such as a phase change, a child event, a commit, a push, or a follow-up. With --follow, the command keeps streaming new entries until you press Ctrl-C.

Synopsis

murmur timeline [flags] [slug]

On a VM, the slug is optional. If you omit it, the command reads the current agent’s timeline.

Arguments

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug, a child path, or an absolute path. Optional on VMs (defaults to self).
`--follow`, `-f`	bool	no	Stream entries live until interrupted. Default: `false`.
`--types`	string	no	Comma-separated body types to include. Empty includes every type. See types.
`--scope`	string	no	Which executions of the slug to read: `current` or `all`. See scope.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Requires agent.read on the agent.

Types

--types accepts these names: phase, child, taskComplete, commit, push, checks, prOpened, costUpdate, upload, followUp, repositoryStatus, attachmentsReady. An unknown name, or an empty entry from a doubled or trailing comma, rejects the whole filter.

Scope

A slug can be reused across executions (for example with murmur spawn --force-new). current reads only entries from the current execution. all reads every execution. When --scope is omitted, the server picks: an agent last spawned with --force-new defaults to current, any other agent defaults to all.

Output

Each entry prints as one line:

  HH:MM:SS [label] detail

The time is the entry’s timestamp. The label and detail depend on the entry:

Label	Detail
`phase`	The phase in lowercase words (for example `task complete`), followed by the turn summary or interruption note.
`child`	The child event and the child’s slug, plus an error when there is one.
`task`	`complete`, or `error: <message>`.
`commit`	The commit SHA and subject.
`push`	`<branch> (<N> commits)`.
`repository-status`	The repository, branch, local HEAD, and staged, modified, untracked, and conflicted file counts.
`upload`	The filename, content type, and URL.
`follow-up`	The follow-up state (`queued` when not yet delivered) and the event type that produced it, such as `pr_comment` or `ci_result`.
`event`	Any other entry type. No detail.

Examples

Print an agent’s timeline

murmur timeline fix-auth

02:11 [phase] running
09:45 [commit] a1b2c3d Fix JWT expiry validation
09:52 [push] murmur/fix-auth (1 commits)
10:03 [phase] task complete Fixed the auth middleware to validate JWT expiry.
10:03 [task] complete
21:40 [follow-up] delivered ci_result

Only commits and pushes

murmur timeline fix-auth --types commit,push

Follow the timeline live

murmur timeline -f fix-auth

Every execution of a reused slug

murmur timeline fix-auth --scope all

Errors

Code	Meaning	What to do
none	`unknown type "<name>"`	Use one of the names listed in types.
none	`unknown scope "<value>" (want "current" or "all")`	Pass `current` or `all`, or omit `--scope`.
`NOT_FOUND`	No agent with that slug exists.	Check the slug with `murmur ls`.
`PERMISSION_DENIED`	You lack `agent.read` on the agent.	Ask for a role that grants `agent.read`. See authorization.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login`.

murmur turns: list an agent’s folded turns
murmur watch: stream an agent’s mailbox events
murmur session watch: stream an agent’s session output
murmur status: check an agent’s current status

Getting Started

Core Concepts

Guides

murmur timeline

Synopsis

Arguments

Types

Scope

Output

Examples

Print an agent’s timeline

Only commits and pushes

Follow the timeline live

Every execution of a reused slug

Errors

​Synopsis

​Arguments

​Types

​Scope

​Output

​Examples

​Print an agent’s timeline

​Only commits and pushes

​Follow the timeline live

​Every execution of a reused slug

​Errors

​Related

Synopsis

Arguments

Types

Scope

Output

Examples

Print an agent’s timeline

Only commits and pushes

Follow the timeline live

Every execution of a reused slug

Errors

Related