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

# murmur report-commit

> Report a git commit you made on behalf of an agent so it appears on the agent's workflow timeline alongside other artifacts and events.

Reports a git commit to the current [agent's](/concepts/agents) 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`](/cli/status) output.

The command uses the `MURMUR_WORKFLOW_ID` environment variable to identify which [agent](/concepts/agents) to report to. It resolves the repository URL from the `--repo` flag or auto-detects it from the `origin` git remote.

## Synopsis

```bash theme={null}
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](/concepts/agents). 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

```bash theme={null}
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

```bash theme={null}
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). |

## Related

* [Agents](/concepts/agents) — concept overview
* [`murmur report-push`](/cli/report-push) — report a git push to the workflow timeline
* [`murmur report-pr`](/cli/report-pr) — attribute a pull request to the agent
* [`murmur status`](/cli/status) — query agent status, including commit count