> ## 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

> Reference for all available commands in the Todo CLI X tool

## Todo CLI X Commands

This page lists all the available commands you can use with `todo`, along with usage examples.

***

### `--version`, `-v`

Display the current installed version of Todo CLI X.

```bash Bash theme={null}
todo --version
# or
todo -v
```

### `add` command

Add a new task to your todo list.

```bash Bash theme={null}
todo add "Write blog post"
```

**Options:**

* `--priority [low|medium|high]` – Set the task’s priority
* `--due YYYY-MM-DD` – Add a due date
* `--tags tag1,tag2` – Assign one or more tags to the task

```bash bash theme={null}
todo add "Finish report" --priority high --due 2025-06-10 --tags work,urgent
```

### `list` command

```bash Bash theme={null}
todo list
```

**Options:**

* `--verbose` – Show creation and due dates
* `--priority [low|medium|high]` – Filter by priority
* `--tags tag1,tag2` – Filter tasks that match at least one of the provided tags

```bash Bash theme={null}
todo list --priority high
todo list --tags dev,urgent
todo list --verbose
```

### `complete` command

Mark one or more tasks as done.

```bash Bash theme={null}
todo complete 3
```

### `delete` command

Delete one or more tasks by their ID.

```bash Bash theme={null}
todo delete 2 5 7
```

### `edit` command

Edit an existing task by its ID. You can change its text, priority, due date, or tags.

```bash Bash theme={null}
todo edit 3 --text "Refactor authentication flow" --priority high --due 2025-06-20 --tags backend,urgent
```

**Options:**

* `--text` – Update the task’s description
* `--priority [low|medium|high]` – Change the task’s priority
* `--due YYYY-MM-DD` – Set a new due date
* `--tags tag1,tag2` – Replace tags with a new set

Any field you omit will be left unchanged.

### `clear` command

<Warning>Delete all tasks (irreversible)</Warning>

```bash Bash theme={null}
todo clear
```

### `--help`

Display help info for the main command or a subcommand.

```bash Bash theme={null}
todo --help
todo add --help
```

<Tip>You can always run `todo <command> --help` to get specific information about that command.</Tip>