# list\_reviews

List the reviews released on a task, the caller's task by default, in snapshot order, each with its verdict.

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

## Calling it

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

```bash
komrad rpc list-reviews
```

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

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

## Request

### ListReviewsRequest

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

## Response

### ListReviewsResponse

| Field | Type | Description |
| --- | --- | --- |
| [`reviews`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ListReviewsResponse-reviews) | [Review\[\]](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review) | Every review on the task, in snapshot order. |

## Types

### Review

Review is a reviewer agent's comments on one snapshot, released to the writer together. The review is private until the agent releases it.

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-id) | uuid\* | The review's id. |
| [`task_id`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-task_id) | uuid\* | The id of the task the review is on. |
| [`snapshot_id`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-snapshot_id) | uuid\* | The id of the snapshot the review is written against. |
| [`snapshot_ordinal`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-snapshot_ordinal) | int32 | The number of the snapshot the review is written against. |
| [`author_kind`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-author_kind) | [ReviewAuthorKind](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewAuthorKind) | Who wrote the review. |
| [`author_agent_id`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-author_agent_id) | uuid | The id of the agent that wrote the review. Unset when a forge user wrote it. |
| [`verdict`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-verdict) | [ReviewVerdict](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewVerdict) | The review's verdict. Unspecified until the review is released. |
| [`released_at`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-released_at) | timestamp | When the review was released. Unset until then. |
| [`path`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-path) | string | The absolute path of the file the released review was written to. |
| [`created_at`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-created_at) | timestamp | When the review was created with its first comment. |
| [`updated_at`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-updated_at) | timestamp | When the review last changed. |
| [`body`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-body) | string | What the author said about the work as a whole. Empty when the author said nothing. |
| [`open_threads`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-open_threads) | int32 | How many of the review's threads are not resolved. A released review with none is finished, whatever its verdict. |
| [`external_login`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-Review-external_login) | string | The forge login of the author of a review copied from the forge. Empty otherwise. |

### ReviewAuthorKind

ReviewAuthorKind is who wrote a review or comment.

| Value | Description |
| --- | --- |
| [`human`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewAuthorKind-human) | The person. |
| [`agent`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewAuthorKind-agent) | An agent, either the writer or a reviewer. |
| [`forge`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewAuthorKind-forge) | A forge user, whose comment komrad copied from the pull request. |

### ReviewVerdict

ReviewVerdict is what a review concludes about a snapshot.

| Value | Description |
| --- | --- |
| [`approved`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewVerdict-approved) | The snapshot is good as it stands. |
| [`changes_requested`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewVerdict-changes_requested) | The writer has more to do. |
| [`commented`](https://komrad.dev/latest/api/agent/list-reviews.md#komrad-agent-v1-ReviewVerdict-commented) | Comments without a conclusion either way. |
