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

todo --version
# or
todo -v

add command

Add a new task to your todo list.

Bash

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

todo add "Finish report" --priority high --due 2025-06-10 --tags work,urgent

list command

Bash

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

todo list --priority high
todo list --tags dev,urgent
todo list --verbose

complete command

Mark one or more tasks as done.

Bash

todo complete 3

delete command

Delete one or more tasks by their ID.

Bash

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

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

Delete all tasks (irreversible)

Bash

todo clear

--help

Display help info for the main command or a subcommand.

Bash

todo --help
todo add --help

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