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

# Commands plan

This document describes all available (and planned) commands for the Todo CLI X application.

***

## Commands overview

This table summarizes the available commands for the Todo CLI X application.

| Command           | Syntax                                                                                              | Description                                               |
| ----------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| `add`             | `todo add "task content" [--priority low\|medium\|high] [--due YYYY-MM-DD]`                         | Add a new task with optional priority and due date        |
| `list`            | `todo list`                                                                                         | List all tasks (completed + not completed)                |
| `list --done`     | `todo list --done`                                                                                  | Show only completed tasks                                 |
| `list --undone`   | `todo list --undone`                                                                                | Show only uncompleted tasks                               |
| `list --priority` | `todo list --priority [low\|medium\|high]`                                                          | Filter tasks by priority                                  |
| `list --sort`     | `todo list --sort priority`                                                                         | Sort tasks by priority (high > medium > low)              |
| `list --verbose`  | `todo list --verbose`                                                                               | Show detailed task info (includes creation date)          |
| `complete`        | `todo complete <id>`                                                                                | Mark a task as completed                                  |
| `delete`          | `todo delete <id1> <id2> ...`                                                                       | Delete one or more tasks by ID                            |
| `edit`            | `todo edit <id> [--text TEXT] [--priority low\|medium\|high] [--due YYYY-MM-DD] [--tags tag1,tag2]` | Edit an existing task (text, priority, due date, or tags) |
| `clear`           | `todo clear`                                                                                        | Delete all tasks                                          |

<Note>
  **Note**

  * `--done` and `--undone` cannot be used together.
  * `--priority` and `--sort` can be combined or used independently.
  * Valid priority levels are: `low`, `medium`, and `high` (default: `medium`).
</Note>

***

## Examples

```bash theme={null}
todo add "Prepare slides" --priority high --due 2025-07-01
  todo add "Renew passport" --due 2025-06-10 # Default priority: medium
todo list
todo list --verbose
todo list --done
todo list --priority high
todo list --sort priority
todo complete 2
todo delete 1
todo delete 2 3
todo edit 3 --text "Update project doc" --priority low --tags docs,review
todo clear
```

## Notes

* All commands are subcommands defined with argparse in main.py
* `--tags` can be used in `add`, `edit`, and `list` commands.
* The `edit` command lets you update one or more fields of an existing task.
* Each command maps to a function in core.py
* The CLI is easily extensible: just add a parser and a corresponding function call.