Commands plan

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.

Command	Syntax	Description
add	todo add "task content" [--priority low|medium|high] [--due YYYY-MM-DD]	Add a new task with optional priority and due date
list	todo list	List all tasks (completed + not completed)
list --done	todo list --done	Show only completed tasks
list --undone	todo list --undone	Show only uncompleted tasks
list --priority	todo list --priority [low|medium|high]	Filter tasks by priority
list --sort	todo list --sort priority	Sort tasks by priority (high > medium > low)
list --verbose	todo list --verbose	Show detailed task info (includes creation date)
complete	todo complete <id>	Mark a task as completed
delete	todo delete <id1> <id2> ...	Delete one or more tasks by ID
edit	todo 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)
clear	todo clear	Delete 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.