This page defines the command-line interface for the Todo CLI X app using Python’s built-in argparse module.

  • Located at: src/todo_cli/main.py
  • Responsible for parsing user commands and calling the appropriate logic from core.py
  • Uses argparse subparsers for clean and extendable command dispatching

​
📂 Location

src/todo_cli/main.py

​
Command flow overview

Line / CodeExplanation
import argparseStandard library to handle command-line arguments
from . import coreImports the task logic from core.py
argparse.ArgumentParser(...)Initializes the main parser
subparsers = parser.add_subparsers(...)Allows for multiple subcommands (add, list, etc.)
add_parser = subparsers.add_parser(...)Defines the add command
add_parser.add_argument(...)Adds a required task text argument
args = parser.parse_args()Parses user input from the command line
if args.command == "add":Checks which command is being called and dispatches to the right logic
print(...)CLI output/feedback to the user

​
Available commands

CommandSyntaxDescription
addtodo add "Task" [--priority low/medium/high] [--due YYYY-MM-DD]Add a new task with priority and due
listtodo list [--done] [--undone] [--priority LEVEL] [--sort priority] [--verbose]List tasks with filters, sort or full details
completetodo complete <id>Mark a task as completed
deletetodo delete <id> [id ...]Delete one or more tasks by ID
edittodo edit <id> [--text TEXT] [--priority LEVEL] [--due YYYY-MM-DD] [--tags tag1,tag2]Edit a task’s fields (text, priority, due date, or tags)
cleartodo clearDelete all tasks
You can also run help for each subcommand
todo add --help
todo list --help

​
Examples

todo add "Submit report" --priority high --due 2025-06-10

todo list
todo list --verbose
todo list --priority high
todo list --sort priority
todo list --done

todo complete 1
todo delete 1
todo delete 2 3 4
todo edit 3 --text "Update report" --priority low --tags admin,review
todo clear

​
Flags & Filters

FlagDescription
--priorityFilter by or assign priority
--dueAdd a due date to a task (YYYY-MM-DD)
--doneShow only completed tasks
--undoneShow only uncompleted tasks
--sortSort tasks (currently only by priority)
--verboseShow detailed task info including created
--tagsAssign or filter tasks by comma-separated tags

​
Testing Your CLI

First, sync your environment with uv:

uv sync

Then, try some commands using uv run:

uv run todo add "Submit report" --priority high --due 2025-06-10
uv run todo list

Or with environment activation:

source .venv/bin/activate
todo add "Submit report" --priority high --due 2025-06-10

​
Notes

  • All commands are handled through argparse subparsers.
  • Each subcommand maps cleanly to logic defined in core.py.
  • New commands can be added easily by repeating the add_parser pattern.
  • The main() function acts as the dispatch layer, keeping CLI modular and maintainable.
This design makes the CLI clean, extensible, and aligned with best practices.