# Task

URL: https://docs.hanzo.ai/docs/cli/task

> The `hanzo task` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/task) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/task) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Hanzo Task: boards, the work items on them, and the filters that make a board.

[API reference →](https://docs.hanzo.ai/docs/openapi/task)

```bash
hanzo task projects list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command             | What it does                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------- |
| `hanzo task board`  | Returns a board's issues — work items with their column, priority, assignee, labels and schedule. |
| `hanzo task issues` | Answers across every project in the org.                                                          |

### Projects

| Command                                     | What it does                                                                                                                                                                                      |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo task projects create`                | Refused — a board is a repository on the forge                                                                                                                                                    |
| `hanzo task projects get <key>`             | Returns one board of your org by its key — the repository name.                                                                                                                                   |
| `hanzo task projects issues claim <key> 1`  | Takes an issue: it becomes yours and it moves to in\_progress.                                                                                                                                    |
| `hanzo task projects issues create <key>`   | Opens a work item on the board, filed as YOU, where the repository lives: an issue on the deployment's forge, or on GitHub for a repository the forge mirrors from there or does not hold at all. |
| `hanzo task projects issues get <key> 1`    | Returns ONE work item in full — its description included.                                                                                                                                         |
| `hanzo task projects issues list <key>`     | Returns a board's issues — work items with their column, priority, assignee, labels and schedule.                                                                                                 |
| `hanzo task projects issues update <key> 1` | Edits a work item — rename it, rewrite it, move it to another column, re-prioritise it, hand it to somebody, or comment on it.                                                                    |
| `hanzo task projects list`                  | Returns the boards of your org — the places your work actually is.                                                                                                                                |
| `hanzo task projects rm <key>`              | Refused — a board is a repository on the forge                                                                                                                                                    |
| `hanzo task projects update <key>`          | Refused — a board is a repository on the forge                                                                                                                                                    |

### Rooms

| Command                       | What it does                |
| ----------------------------- | --------------------------- |
| `hanzo task rooms get <room>` | Summarises one room's work. |