Skip to main content
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

NameTypeRequiredDescription
branchstringyesThe branch being pushed.
countintegeryesThe number of commits in the push.
--repostringnoRepository URL (HTTPS, SSH, or scp-style). Auto-detected from the origin git remote when omitted.
--filestringnoA repo-relative file path included in the push. Repeatable — pass once per file.

​
Environment variables

NameRequiredDescription
MURMUR_WORKFLOW_IDyesIdentifies the current agent. Set automatically on agent VMs.
MURMUR_RUN_IDnoThe 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

CodeMeaningWhat to do
MURMUR_WORKFLOW_ID not setThe 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 countThe count argument is not a valid integer.Pass a numeric commit count as the second positional argument.
INVALID_ARGUMENTThe 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.
INTERNALThe 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).