Cheat Sheet

Quick Start

sd-todo config move ~/todos      # Set location (once)
sd-todo + Buy milk               # Add todo
sd-todo l                        # List todos
sd-todo co 1                     # Complete todo
sd-todo tui                      # Launch TUI

Commands

ActionCommandShortcut
Addadd <text>a, +
Listlistl, ls
Pendingpendingp
Donedoned
Completecomplete <id>co
Deletedelete <id>rm, -
Editedit <id> <text>e
Searchsearch <word>/
Archivearchivear
Archive Statsarchive stats-
Clearclear-
Configconfigcf
Helphelph
TUItuiui
Exitexitq

Examples

sd-todo + Buy milk               # Add
sd-todo l                        # List all
sd-todo p                        # List pending
sd-todo d                        # List done
sd-todo co 1                     # Complete #1
sd-todo co 1 2 3                 # Complete multiple
sd-todo e 1 Buy eggs             # Edit #1
sd-todo / milk                   # Search
sd-todo - 1                      # Delete #1
sd-todo - 1 2 3                  # Delete multiple
sd-todo archive                  # Archive completed
sd-todo archive stats            # View archive stats
sd-todo clear                    # Clear completed

Categories

sd-todo cat                      # List categories
sd-todo c work                   # Switch to work
sd-todo cat + personal           # Create personal
sd-todo cat - work               # Delete work
sd-todo list all                 # All from all categories
sd-todo list cat work personal   # From specific categories

TUI Keys

KeyActionKeyAction
Up/kUpaAdd todo
Down/jDowneEdit
TabSwitch panedDelete
EnterSelectSpaceToggle
/SearchfFilter
cClear+Add category*
-Del category*F1/hHelp
EscCancelqQuit

*When in Categories pane

Config

sd-todo config                   # Show config
sd-todo config move ~/new-path   # Move/merge

Config file: ~/.config/sidedraft-md-todo/config.json

Starship

Add to ~/.config/starship.toml:

[custom.sdtodo]
command = "sidedraft-md-todo --status"
when = 'test -f ~/.config/sidedraft-md-todo/config.json'
format = "[$symbol$output]($style) "
symbol = "📝 "
style = "bold yellow"

Tips

  • Use + and - for super-fast add/delete
  • Use p and d for quick filtering
  • Use archive to keep your list clean while preserving history
  • Use archive stats to review your productivity
  • Use TUI for review sessions
  • Store in Dropbox/iCloud for sync
  • Use git for version control

Files

  • Single file: todos.md
  • Folder mode: todos/work.md, todos/personal.md, etc.
  • Archives: todos/work_archive_2026.md (yearly rollover)
  • Format: Standard markdown checkboxes with metadata