murmur report-pr

Attributes an existing pull request to the current agent as an artifact. This command runs on an agent VM. The gh wrapper calls it after creating a PR, the git shim calls it when a pushed branch has an open PR, and workspace preparation calls it when an adopted branch already has one. It records the PR URL, title, head branch, state, and review 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, state, and review decision from GitHub with gh pr view. 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

Name	Type	Required	Description
`pr-url`	string	yes	The full URL of the pull request to attribute (e.g. `https://github.com/acme/backend/pull/42`).
`--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_RUN_ID`	no	The current run identifier. Set automatically on agent VMs. Must be a nonnegative integer when set.

Examples

Attribute a pull request

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

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.
`--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 retries `UNAVAILABLE` errors up to 3 times with a short backoff, within a 15-second deadline.	Retry the command.

Agents: concept overview
murmur report-commit: report a git commit to the workflow timeline
murmur report-push: report a git push to the workflow timeline
murmur status: query agent status, including PR output

Getting Started

Core Concepts

Guides

murmur report-pr

Synopsis

Arguments

Environment variables

Examples

Attribute a pull request

Attribute a pull request with an explicit repository URL

Errors

​Synopsis

​Arguments

​Environment variables

​Examples

​Attribute a pull request

​Attribute a pull request with an explicit repository URL

​Errors

​Related

Synopsis

Arguments

Environment variables

Examples

Attribute a pull request

Attribute a pull request with an explicit repository URL

Errors

Related