# barndog changes (/docs/cli/changes)

`<id>` is the Suggested Change ID that `barndog push` prints. Reviews and merges always take the `--revision` you inspected. For a walkthrough, see [Review and merge Suggested Changes](/docs/guides/review-changes).

## `barndog changes list` [#barndog-changes-list]

Lists the Suggested Changes you can access.

## `barndog changes show <id>` [#barndog-changes-show-id]

Shows the proposal's content, reviews, and discussion history.

## `barndog changes diff <id>` [#barndog-changes-diff-id]

Shows a revision's file changes.

| Option                     | Description                       |
| -------------------------- | --------------------------------- |
| `--revision <number>`      | The revision to show.             |
| `--from-revision <number>` | Compare it with another revision. |

## `barndog changes comment <id>` [#barndog-changes-comment-id]

Adds a comment, replies to a discussion, or suggests replacement text for specific lines.

| Option                      | Description                                               |
| --------------------------- | --------------------------------------------------------- |
| `--revision <number>`       | Required. The revision you're commenting on.              |
| `--body <text>`             | The comment text.                                         |
| `--body-file <path>`        | Read the comment text from a file.                        |
| `--thread <id>`             | Reply to an existing discussion.                          |
| `--path <path>`             | The file, for a comment on specific lines.                |
| `--side <side>`             | `old` or `new`: which side of the diff the lines are on.  |
| `--start-line <number>`     | The first line.                                           |
| `--end-line <number>`       | The last line.                                            |
| `--replacement-file <path>` | A file containing the replacement text you suggest.       |
| `--expected-file <path>`    | A file containing the exact original text being replaced. |

## `barndog changes approve <id>` [#barndog-changes-approve-id]

Approves the revision you reviewed.

| Option                | Description                          |
| --------------------- | ------------------------------------ |
| `--revision <number>` | Required. The revision you reviewed. |

Approving doesn't publish. Someone still has to merge.

## `barndog changes request-changes <id>` [#barndog-changes-request-changes-id]

Asks the author for more changes. Your request keeps blocking until you approve a later revision.

| Option                | Description                          |
| --------------------- | ------------------------------------ |
| `--revision <number>` | Required. The revision you reviewed. |

## `barndog changes merge <id>` [#barndog-changes-merge-id]

Publishes the change as the asset's next version, following its scope's merge rules.

| Option                | Description                          |
| --------------------- | ------------------------------------ |
| `--revision <number>` | Required. The revision you reviewed. |

## `barndog changes reject <id>` [#barndog-changes-reject-id]

Closes the proposal. Only the author or an admin can reject.

| Option                | Description                          |
| --------------------- | ------------------------------------ |
| `--revision <number>` | Required. The revision you reviewed. |

## `barndog changes apply <id> <thread>` [#barndog-changes-apply-id-thread]

Applies a reviewer's suggested replacement. This creates a new revision, and the author runs `barndog pull` to receive it.

| Option                | Description                     |
| --------------------- | ------------------------------- |
| `--revision <number>` | Required. The current revision. |

## `barndog changes resolve-discussion <id> <thread>` [#barndog-changes-resolve-discussion-id-thread]

Marks a discussion as resolved.

| Option                | Description                     |
| --------------------- | ------------------------------- |
| `--revision <number>` | Required. The current revision. |

## `barndog changes reopen-discussion <id> <thread>` [#barndog-changes-reopen-discussion-id-thread]

Reopens a resolved discussion.

| Option                | Description                     |
| --------------------- | ------------------------------- |
| `--revision <number>` | Required. The current revision. |