murmur report-commit

Reports a git commit to the current agent’s workflow timeline. This command runs on an agent VM. The VM’s git shim calls it after each commit. It records the commit SHA, subject, branch, and repository so the commit appears in the agent’s progress history and in murmur status output. 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-commit [--repo <url>] [--committed-at <unix>] <sha> <subject>

Arguments

Name	Type	Required	Description
`sha`	string	yes	The commit SHA to report.
`subject`	string	yes	The commit’s subject line.
`--repo`	string	no	Repository URL (HTTPS, SSH, or scp-style). Auto-detected from the `origin` git remote when omitted.
`--committed-at`	string	no	The commit’s committer timestamp in unix seconds (git `%ct`). Used to order commits when filtering stale check runs. The git shim always passes it.

Environment variables

Name	Required	Description
`MURMUR_WORKFLOW_ID`	yes	Identifies the current agent. Set automatically on agent VMs.
`MURMUR_BRANCH`	no	The branch name associated with the commit. 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 commit

murmur report-commit a1b2c3d4 "Fix JWT expiry validation in auth middleware"

The repository and branch are auto-detected from the git remote and environment.

Report a commit with an explicit repository URL

murmur report-commit --repo https://github.com/acme/backend.git a1b2c3d4 "Fix JWT expiry validation"

Errors

Code	Meaning	What to do
`MURMUR_WORKFLOW_ID not set — report-progress 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.
`MURMUR_RUN_ID not set — report-commit must run during a task turn`	The command ran outside a task turn.	Run it on the VM during a turn.
`invalid --committed-at "<value>": ...`	`--committed-at` is not an integer.	Pass unix seconds, as from `git log -1 --format=%ct`.
`--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 has a 15-second deadline and does not retry.	Retry the command.

Agents: concept overview
murmur report-push: report a git push 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-commit

Synopsis

Arguments

Environment variables

Examples

Report a commit

Report a commit with an explicit repository URL

Errors

​Synopsis

​Arguments

​Environment variables

​Examples

​Report a commit

​Report a commit with an explicit repository URL

​Errors

​Related

Synopsis

Arguments

Environment variables

Examples

Report a commit

Report a commit with an explicit repository URL

Errors

Related