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

# guillo tasks

> Manage tasks within a project.

Requires an active project (`guillo lock project <id>`).

## Commands

### `guillo tasks list`

List all tasks in the active project.

```sh theme={null}
guillo tasks list
```

### `guillo tasks get <id>`

Get a single task by ID, including its description.

```sh theme={null}
guillo tasks get <task-id>
```

### `guillo tasks create <title>`

Create a new task.

```sh theme={null}
guillo tasks create <title>
guillo tasks create <title> --description <text>
guillo tasks create <title> --status in_progress
```

| Flag                   | Description                                  | Default |
| ---------------------- | -------------------------------------------- | ------- |
| `--description <text>` | Optional description or details for the task | —       |
| `--status <status>`    | Initial status (see below)                   | `open`  |

### `guillo tasks update <id>`

Update an existing task. At least one flag is required.

```sh theme={null}
guillo tasks update <task-id> --title <title>
guillo tasks update <task-id> --status <status>
guillo tasks update <task-id> --description <text>
```

| Flag                   | Description                                  |
| ---------------------- | -------------------------------------------- |
| `--title <text>`       | New title                                    |
| `--description <text>` | New description (pass empty string to clear) |
| `--status <status>`    | New status (see below)                       |

### `guillo tasks delete <id>`

Delete a task. Prompts for confirmation on a TTY.

```sh theme={null}
guillo tasks delete <task-id>
```

## Statuses

`open` → `in_progress` → `executed` | `pardoned`

## Execute a task

```sh theme={null}
guillo execute <task-id>
```