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.

CommandSyntaxDescription
addtodo add "task content" [--priority low|medium|high] [--due YYYY-MM-DD]Add a new task with optional priority and due date
listtodo listList all tasks (completed + not completed)
list --donetodo list --doneShow only completed tasks
list --undonetodo list --undoneShow only uncompleted tasks
list --prioritytodo list --priority [low|medium|high]Filter tasks by priority
list --sorttodo list --sort prioritySort tasks by priority (high > medium > low)
list --verbosetodo list --verboseShow detailed task info (includes creation date)
completetodo complete <id>Mark a task as completed
deletetodo delete <id1> <id2> ...Delete one or more tasks by ID
edittodo 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)
cleartodo clearDelete all tasks

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

​
Examples

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.