Skip to main content

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