​
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.