# list\_review\_snapshots

List the snapshots of a task, the caller's task by default, oldest first.

read-only · idempotent · MCP tool · [Agent](https://komrad.dev/latest/api/agent.md)

Diff one snapshot's `sha` against the next to see what changed between them.

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ListReviewSnapshots \
  -H 'Content-Type: application/json' \
  -d '{}'
```

```bash
komrad rpc list-review-snapshots
```

```json
{
  "name": "list_review_snapshots",
  "arguments": {}
}
```

Offered by the komrad MCP server to writer, reviewer, orchestrator agents.

## Request

### ListReviewSnapshotsRequest

| Field | Type | Description |
| --- | --- | --- |
| [one of](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ListReviewSnapshotsRequest-task) |  | The task whose snapshots to list. Unset uses the caller's own task. |
| [`task_id`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ListReviewSnapshotsRequest-task_id) | uuid | The task, by id. |
| [`task_slug`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ListReviewSnapshotsRequest-task_slug) | string not empty | The task, by slug. |

## Response

### ListReviewSnapshotsResponse

| Field | Type | Description |
| --- | --- | --- |
| [`snapshots`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ListReviewSnapshotsResponse-snapshots) | [ReviewSnapshot\[\]](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot) | Every snapshot of the task, oldest first. |

## Types

### ReviewSnapshot

ReviewSnapshot is a snapshot of a task's worktree, saved as a commit, that a review is written against. A snapshot never changes.

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot-id) | uuid\* | The snapshot's id. |
| [`task_id`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot-task_id) | uuid\* | The id of the task the snapshot was taken of. |
| [`ordinal`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot-ordinal) | int32 | The snapshot's number within its task, counting from one. |
| [`base_sha`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot-base_sha) | string | The commit on the base branch that the task's branch started from when the snapshot was taken. |
| [`sha`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot-sha) | string | The commit holding the whole worktree, tracked and untracked files alike. |
| [`created_at`](https://komrad.dev/latest/api/agent/list-review-snapshots.md#komrad-agent-v1-ReviewSnapshot-created_at) | timestamp | When the snapshot was taken. |
