Documentation Index
Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
Use this file to discover all available pages before exploring further.
Reports a git commit to the current agent’s workflow timeline. This command runs on an agent VM, called from the post-commit git hook. 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>] <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. |
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 | no | The current run identifier. Set automatically on agent VMs. |
Examples
Report a commit from a post-commit hook
murmur report-commit a1b2c3d4 "Fix JWT expiry validation in auth middleware"
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 | 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_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). |
