murmur report-push

Reports a git push to the current agent’s workflow timeline. This command runs on an agent VM. The VM’s git shim calls it after a push lands a branch. It records the branch name, commit count, the pushed head commit, and optionally a list of changed files so the push appears in the agent’s progress history. The file list is filtered by content: only files whose blob at --src differs from the last successfully reported push on the same branch are reported. Rebases and unrelated pushes therefore do not re-trigger files_modified tasks on unchanged files. The command uses the MURMUR_WORKFLOW_ID environment variable to identify which agent to report to. It resolves the repository URL from the --repo flag or auto-detects it from the origin git remote.

Synopsis

murmur report-push --src <sha> [--head-subject <text>] [--repo <url>] [--file <path>]... <branch> <count>

Arguments

Name	Type	Required	Description
`branch`	string	yes	The branch being pushed.
`count`	integer	yes	The number of commits in the push.
`--src`	string	yes	The commit SHA the push placed on the remote branch. Reported as the push’s head.
`--head-subject`	string	no	Subject line of the `--src` commit, so readers can name the pushed commit without a GitHub lookup.
`--repo`	string	no	Repository URL (HTTPS, SSH, or scp-style). Auto-detected from the `origin` git remote when omitted.
`--file`	string	no	A repo-relative file path included in the push. Repeatable: pass once per file.

Environment variables

Name	Required	Description
`MURMUR_WORKFLOW_ID`	yes	Identifies the current agent. Set automatically on agent VMs.
`MURMUR_RUN_ID`	yes	The current run identifier. Set automatically on agent VMs during a task turn.

Examples

Report a push

murmur report-push --src 9f1c2e4b7a3d5e6f8091a2b3c4d5e6f708192a3b --head-subject "Fix JWT expiry validation" fix/auth-expiry 3

The repository is auto-detected from the origin git remote.

Report a push with changed files

murmur report-push --src 9f1c2e4b7a3d5e6f8091a2b3c4d5e6f708192a3b --file internal/auth/jwt.go --file internal/auth/jwt_test.go fix/auth-expiry 3

Report a push with an explicit repository URL

murmur report-push --src 9f1c2e4b7a3d5e6f8091a2b3c4d5e6f708192a3b --repo https://github.com/acme/backend.git fix/auth-expiry 3

Errors

Code	Meaning	What to do
`MURMUR_WORKFLOW_ID not set — report-push must run on a VM`	The command is not running on an agent VM.	This command is VM-only. It requires the `MURMUR_WORKFLOW_ID` environment variable set by the agent runtime.
`--src not set — report-push requires the pushed commit (the git shim always passes it)`	`--src` was omitted.	Pass the pushed commit SHA with `--src`.
`MURMUR_RUN_ID not set — report-push must run during a task turn`	The command ran outside a task turn.	Run it on the VM during a turn.
`invalid commit count "<value>": ...`	The `count` argument is not a valid integer.	Pass a numeric commit count as the second positional argument.
`--repo not specified and git remote detection failed: ...`	`--repo` was omitted and `git remote get-url origin` failed.	Pass `--repo`, or run inside a repository with an `origin` remote.
`could not canonicalize repo "<value>": ...`	The repository URL is not a valid clone URL.	Pass an HTTPS, SSH, or scp-style clone URL with `--repo`.
`report progress: ...`	The progress report failed. The command retries transient errors with backoff within a 15-second deadline.	Retry the command.

Agents: concept overview
murmur report-commit: report a git commit to the workflow timeline
murmur report-pr: attribute a pull request to the agent
murmur status: query agent status, including commit count

Getting Started

Core Concepts

Guides

murmur report-push

Synopsis

Arguments

Environment variables

Examples

Report a push

Report a push with changed files

Report a push with an explicit repository URL

Errors

​Synopsis

​Arguments

​Environment variables

​Examples

​Report a push

​Report a push with changed files

​Report a push with an explicit repository URL

​Errors

​Related

Synopsis

Arguments

Environment variables

Examples

Report a push

Report a push with changed files

Report a push with an explicit repository URL

Errors

Related