murmur report-push

Reports a git push to the current agent’s workflow timeline. This command runs on an agent VM, called from the pre-push git hook. It records the branch name, commit count, and optionally a list of changed files so the push appears in the agent’s progress history. 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 [--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.
`--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`	no	The current run identifier. Set automatically on agent VMs.

Examples

Report a push from a pre-push hook

murmur report-push fix/auth-expiry 3

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

Report a push with changed files

murmur report-push --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 --repo https://github.com/acme/backend.git fix/auth-expiry 3

Errors

Code	Meaning	What to do
`MURMUR_WORKFLOW_ID not set`	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.
`invalid commit count`	The `count` argument is not a valid integer.	Pass a numeric commit count as the second positional argument.
`INVALID_ARGUMENT`	The repository URL is missing or not a valid clone URL.	Pass a valid repository URL with `--repo`, or ensure the `origin` git remote is configured.
`INTERNAL`	The progress signal could not be delivered to the workflow.	Retry the operation. The command retries transient errors automatically with exponential backoff (up to 3 retries within a 15-second deadline).

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 from a pre-push hook

Report a push with changed files

Report a push with an explicit repository URL

Errors

​Synopsis

​Arguments

​Environment variables

​Examples

​Report a push from a pre-push hook

​Report a push with changed files

​Report a push with an explicit repository URL

​Errors

​Related

Synopsis

Arguments

Environment variables

Examples

Report a push from a pre-push hook

Report a push with changed files

Report a push with an explicit repository URL

Errors

Related