Skip to main content
Attributes an existing pull request to the current agent as an artifact. This command runs on an agent VM, called from the pre-push git hook when the pushed branch already has an open pull request. It records the PR URL, title, head branch, and state so the PR appears in the agent’s progress history and in murmur status output. The command fetches the PR’s title, head branch, and state from GitHub automatically. If the lookup fails, the PR is still attributed — the URL alone is sufficient. 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-pr [--repo <url>] <pr-url>

​
Arguments

NameTypeRequiredDescription
pr-urlstringyesThe full URL of the pull request to attribute (e.g. https://github.com/acme/backend/pull/42).
--repostringnoRepository URL (HTTPS, SSH, or scp-style). Auto-detected from the origin git remote when omitted.

​
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

​
Attribute a pull request from a pre-push hook

murmur report-pr https://github.com/acme/backend/pull/42
The repository is auto-detected from the origin git remote. The PR title, head branch, and state are fetched from GitHub.

​
Attribute a pull request with an explicit repository URL

murmur report-pr --repo https://github.com/acme/backend.git https://github.com/acme/backend/pull/42

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