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

# Statuses

> List workflow statuses with the `hirotm statuses` CLI.

**Workflow statuses** are the task states the app knows about (for example **open**, **in progress**, **closed**). **`hirotm statuses list`** returns the full set in display order—the same **`statusId`** strings **`tasks add`** and **`tasks update`** accept for **`--status`**.

This route is **not** tied to a single board: every board uses the same global status table. Global options and output modes: [hirotm CLI](/task-manager/cli/cli-commands).

For shared connection options (**`--profile`**, **`--client-name`**), see [hirotm CLI](/task-manager/cli/cli-commands). Task commands that set status are documented in [Tasks](/task-manager/cli/tasks).

***

## `statuses list`

| Option                 | Type                                         | Required                        | Description                                                                                                                                                       |
| ---------------------- | -------------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--client-name <name>` | <Badge size="sm" color="blue">string</Badge> | <Icon icon="minus" size={14} /> | Optional; included for consistency with other commands (this call is read-only).                                                                                  |
| `--fields <keys>`      | <Badge size="sm" color="blue">string</Badge> | <Icon icon="minus" size={14} /> | Comma-separated API keys per row. Allowed: `statusId`, `label`, `sortOrder`, `isClosed`. See [Field projection](/task-manager/cli/cli-commands#field-projection). |

Accepts global **`-q` / `--quiet`** (with **`--format ndjson`**); default field **`statusId`**. See [Pipe-friendly quiet](/task-manager/cli/cli-commands#pipe-friendly-quiet).

**CLI Examples**

```bash theme={null}
hirotm statuses list
hirotm statuses list --fields statusId,label,isClosed
hirotm statuses list --profile dev                          # non-default profile
```

**AI Agent Examples**

<Prompt description="List all workflow status ids and labels from Task Manager." actions={["copy", "cursor"]}>
  List all workflow status ids and labels from Task Manager.
</Prompt>

<Expandable title="Example responses" defaultOpen={false}>
  <CodeGroup>
    ```json json theme={null}
    {"statusId":"open","label":"Open","sortOrder":0,"isClosed":false}
    {"statusId":"in-progress","label":"In progress","sortOrder":1,"isClosed":false}
    {"statusId":"closed","label":"Closed","sortOrder":2,"isClosed":true}
    ```

    ```text human theme={null}
    StatusId       Label            Ord Closed
    -------------- ---------------- --- ------
    open           Open             0   false
    in-progress    In progress      1   false
    closed         Closed           2   true
    count 3
    ```

    ```json error theme={null}
    {
      "error": "Server not reachable"
    }
    ```
  </CodeGroup>
</Expandable>

| Field           | Meaning                                               |
| --------------- | ----------------------------------------------------- |
| **`statusId`**  | String you pass as **`--status`** on task commands.   |
| **`label`**     | Human-readable name (shown in the app).               |
| **`sortOrder`** | Display order in the workflow.                        |
| **`isClosed`**  | Whether this status counts as “done” for UI behavior. |

***

## Learn more

Run **`hirotm help statuses`** for subcommand help. For how CLI access works on board routes, see [CLI access policy](/task-manager/cli/cli-access-policy).