> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ankra tickets

> Work the AI board: list tickets, read one, comment, move it, answer a decision

## ankra tickets

Work the organisation's AI board from the terminal.

The AI board is where Ankra's agents track incidents, insights and requests
as tickets. These commands list the board, show one ticket with its
timeline, comment on it, move it through its lifecycle, and answer the
decision a blocked ticket is waiting on - the same choice the ticket page
renders as options plus "something else".

A ticket is referenced by its number (8, T-8 or #8) or its UUID.

## ankra tickets comment

Post a comment on a ticket as yourself. A comment on a blocked ticket
hands it back to its agent; to answer a choice the agent offered, use
"ankra tickets decide" instead so the answer is recorded as the decision.

```bash theme={null}
ankra tickets comment <ticket> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--body`         |         | The comment (markdown)                                |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra tickets decide

Answer the decision a blocked ticket is waiting on. Pick one of the
options the agent offered with --option \<key> (see "ankra tickets get"),
or give the decision in your own words with --answer. Both together record
the option with your note beside it. The answer lands on the timeline as a
"Decision:" comment and the agent resumes from it.

```bash theme={null}
ankra tickets decide <ticket> [flags]
```

**Flags**

| Flag             | Default | Description                                               |
| ---------------- | ------- | --------------------------------------------------------- |
| `--answer`       |         | The decision in your own words, or a note beside --option |
| `--option`       |         | Key of the offered option to choose                       |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable)     |

## ankra tickets events

Show a ticket's timeline, oldest first

```bash theme={null}
ankra tickets events <ticket> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--limit`        | `200`   | Maximum events to show                                |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra tickets get

Show one ticket, including the decision it is waiting on

```bash theme={null}
ankra tickets get <ticket> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra tickets list

List the board's tickets, newest first

```bash theme={null}
ankra tickets list [flags]
```

**Flags**

| Flag               | Default | Description                                                                                                                                                  |
| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--include-closed` | `false` | Include done and cancelled tickets                                                                                                                           |
| `--limit`          | `50`    | Maximum tickets to list (up to 200)                                                                                                                          |
| `--needs-human`    | `false` | Only tickets waiting on a person                                                                                                                             |
| `-o`, `--output`   |         | Output format: json or yaml (default: human-readable)                                                                                                        |
| `--search`         |         | Match on the title                                                                                                                                           |
| `--status`         | `[]`    | Only these statuses (comma-separated: triage, investigating, planning, awaiting\_review, awaiting\_approval, executing, verifying, blocked, done, cancelled) |

## ankra tickets transition

Move a ticket to another status

```bash theme={null}
ankra tickets transition <ticket> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--note`         |         | Why the ticket is moving                              |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--status`       |         | The status to move to                                 |