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

> Report a git update made on behalf of an agent so the new commits and branch appear on the agent's workflow timeline in the dashboard.

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

```bash theme={null}
murmur report-push fix/auth-expiry 3
```

The repository is auto-detected from the `origin` git remote.

### Report a push with changed files

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

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

## Related

* [Agents](/concepts/agents) — concept overview
* [`murmur report-commit`](/cli/report-commit) — report a git commit 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