CLI Reference

Command Shortcuts

Single Character Commands

Command	Shortcut	Description
list	`l`	List all todos
add	`a`	Add a new todo
cat	`c`	Category commands
edit	`e`	Edit a todo
help	`h`	Show help
quit	`q`	Exit application
pending	`p`	List pending todos
done	`d`	List completed todos
search	`/`	Search todos

Symbol Commands

Symbol	Description
`+`	Add a new todo
`-`	Delete a todo

Adding Todos

sd-todo + Buy milk
sd-todo a Buy eggs
sd-todo add Buy bread

Listing Todos

sd-todo l              # List all
sd-todo ls             # List all
sd-todo list           # List all
sd-todo p              # Pending only
sd-todo d              # Completed only

Completing Todos

sd-todo co 1           # Toggle todo #1
sd-todo co 1 2 3       # Toggle multiple

Deleting Todos

sd-todo - 1            # Delete todo #1
sd-todo rm 1           # Delete todo #1
sd-todo - 1 2 3        # Delete multiple

Editing Todos

sd-todo e 1 New description
sd-todo edit 1 Updated text

Searching

sd-todo / milk         # Search for "milk"
sd-todo search milk    # Search for "milk"

Archiving

Archive completed todos to keep your active list clean while preserving history:

sd-todo archive        # Archive all completed in current category
sd-todo ar             # Short form
sd-todo archive stats  # View archive statistics

Archives are organized by year (Work_archive_2026.md) and preserve all metadata including timestamps.

Clearing Completed

sd-todo clear          # Delete all completed todos (permanent!)

Use archive instead of clear to preserve your work history.

Configuration

sd-todo config         # Show current config
sd-todo cf             # Short form
sd-todo config move ~/new-path    # Move/merge todos
sd-todo config mv ~/new-path      # Short form

Category Commands

sd-todo c              # List all categories
sd-todo cat            # List all categories
sd-todo c work         # Switch to "work" category
sd-todo c + work       # Create "work" category
sd-todo c - work       # Delete "work" category

Cross-Category Listing

sd-todo list all              # All todos from all categories
sd-todo list all p            # All pending from all categories
sd-todo list cat work         # Todos from "work" category
sd-todo list cat work personal # Todos from multiple categories

Interactive Mode

Start interactive mode:

sd-todo

Interactive commands:

All CLI commands work
Up/Down arrows for command history
Ctrl-C to cancel input
Ctrl-D or exit to quit

Environment Variables

Variable	Description	Example
`SD_TODO_PATH`	Override todo location	`export SD_TODO_PATH=~/todos`

Examples by Use Case

Personal Task Management

sd-todo + Buy groceries
sd-todo + Call mom
sd-todo + Pay bills
sd-todo p              # See what's pending

Work Projects

sd-todo c + project-alpha
sd-todo c project-alpha
sd-todo + Write documentation
sd-todo + Review code
sd-todo + Deploy to staging

Daily Review

sd-todo p              # What's pending?
sd-todo d              # What did I complete?
sd-todo archive        # Archive completed