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 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
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). |
