# kindgi reviewers

> Manage HITL reviewers

## `kindgi reviewers`

**Synopsis**

```sh signature
kindgi reviewers <command>
```

Manage HITL reviewers.

**Commands**

| Command                                                                                                                 | Description                                                                     |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [`kindgi reviewers list`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers-list)             | List reviewers.                                                                 |
| [`kindgi reviewers get`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers-get)               | Fetch a reviewer by id.                                                         |
| [`kindgi reviewers register`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers-register)     | Register a reviewer — `{ userId?, role, displayName? }`; without `userId`, you. |
| [`kindgi reviewers unregister`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers-unregister) | Unregister a reviewer: their decisions stay, no new approvals go to them.       |

**See also**

- [Ask before a tool runs](https://docs.kindgi.com/v0.1.10/guides/approvals/ask-before-a-tool-runs.md)
- [Decide an approval](https://docs.kindgi.com/v0.1.10/guides/approvals/decide-an-approval.md)
- [Wait for an approval](https://docs.kindgi.com/v0.1.10/guides/flows/wait-for-an-approval.md)

### `kindgi reviewers list`

**Synopsis**

```sh signature
kindgi reviewers list [--limit=<n>] [--cursor=<c>]
```

List reviewers.

**Options**

| Option             | Default              | Description                                                      |
| ------------------ | -------------------- | ---------------------------------------------------------------- |
| `--cursor <value>` | none                 | Resume after this cursor, from the previous page's `nextCursor`. |
| `--limit <value>`  | `25` (at most `100`) | The most reviewers to return (default 25, at most 100).          |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.10/reference/cli.md#global-flags).

**Examples**

From [Decide an approval](https://docs.kindgi.com/v0.1.10/guides/approvals/decide-an-approval.md):

```sh
pnpm exec kindgi reviewers list
```

**See also**

- [Decide an approval](https://docs.kindgi.com/v0.1.10/guides/approvals/decide-an-approval.md)
- [`kindgi reviewers`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers)

### `kindgi reviewers get`

**Synopsis**

```sh signature
kindgi reviewers get <reviewer-id>
```

Fetch a reviewer by id.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.10/reference/cli.md#global-flags).

**Examples**

Show one reviewer.

```sh
kindgi reviewers get <reviewer-id>
```

**See also**

- [Ask before a tool runs](https://docs.kindgi.com/v0.1.10/guides/approvals/ask-before-a-tool-runs.md)
- [Decide an approval](https://docs.kindgi.com/v0.1.10/guides/approvals/decide-an-approval.md)
- [Wait for an approval](https://docs.kindgi.com/v0.1.10/guides/flows/wait-for-an-approval.md)
- [`kindgi reviewers`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers)

### `kindgi reviewers register`

**Synopsis**

```sh signature
kindgi reviewers register --spec=<json-or-@file>
```

Register a reviewer — `{ userId?, role, displayName? }`; without `userId`, you. Registering again changes the role.

**Options**

| Option           | Default  | Description                                                                                                                                            |
| ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--spec <value>` | required | The reviewer as inline JSON or `@<file>`: `role` (`standard`, `senior` or `admin`), plus optional `userId` (default: you) and `displayName`. Required. |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.10/reference/cli.md#global-flags).

**Examples**

From [Ask before a tool runs](https://docs.kindgi.com/v0.1.10/guides/approvals/ask-before-a-tool-runs.md):

```sh
pnpm exec kindgi reviewers register --spec='{"role":"standard","displayName":"Ada Lovelace"}'
```

From [Wait for an approval](https://docs.kindgi.com/v0.1.10/guides/flows/wait-for-an-approval.md):

```sh
pnpm exec kindgi reviewers register --spec='{"role":"standard"}'
```

**See also**

- [Ask before a tool runs](https://docs.kindgi.com/v0.1.10/guides/approvals/ask-before-a-tool-runs.md)
- [Decide an approval](https://docs.kindgi.com/v0.1.10/guides/approvals/decide-an-approval.md)
- [Wait for an approval](https://docs.kindgi.com/v0.1.10/guides/flows/wait-for-an-approval.md)
- [`kindgi reviewers`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers)

### `kindgi reviewers unregister`

**Synopsis**

```sh signature
kindgi reviewers unregister <reviewer-id>
```

Unregister a reviewer: their decisions stay, no new approvals go to them.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.10/reference/cli.md#global-flags).

**Examples**

Stop sending new approvals to a reviewer.

```sh
kindgi reviewers unregister <reviewer-id>
```

**See also**

- [Ask before a tool runs](https://docs.kindgi.com/v0.1.10/guides/approvals/ask-before-a-tool-runs.md)
- [Decide an approval](https://docs.kindgi.com/v0.1.10/guides/approvals/decide-an-approval.md)
- [Wait for an approval](https://docs.kindgi.com/v0.1.10/guides/flows/wait-for-an-approval.md)
- [`kindgi reviewers`](https://docs.kindgi.com/v0.1.10/reference/cli/reviewers.md#kindgi-reviewers)