A local todo manager. Stores todos as markdown files in .todo/.

tdo                          # TUI (interactive) or list open todos (non-interactive)
tdo some text here           # Create a todo with title "some text here"
tdo add "title" --body "..." # Create a todo with title and body at once
tdo show <id>                # View a todo's full details (metadata + body)
tdo --edit <id>              # Open todo in $VISUAL/$EDITOR
tdo --done <id>              # Mark todo as done
tdo --reopen <id>            # Reopen a done todo
tdo --delete <id>            # Delete todo file (prompts if interactive)
tdo --delete <id> --force    # Delete without confirmation
tdo --list                   # List open todos
tdo --list --all             # List all todos including done
tdo count                    # Print number of open todos
tdo count --all              # Print number of all todos including done
tdo --assign <id> [name]     # Assign todo (optionally to a person)
tdo --unassign <id>          # Remove assignment from todo

ID arguments accept unique prefixes (e.g. a3 instead of a3f9).

--dir <path>                 # Override .todo/ directory location
--force                      # Skip confirmation (with --delete)

---
title: some text here
created: 2026-02-20T14:30:52
status: open
assigned: someone
assigned_at: 2026-02-21T22:58:00
done_at: 2026-02-21T23:00:00
---

Optional body content.

The assigned, assigned_at, and done_at fields are optional and omitted when not set. assigned_at records the timestamp when the todo was first assigned. done_at records the timestamp when the todo was first marked done. When listing todos, assigned todos show a magenta (assigned) or (assigned: name) suffix.

The --list command performs automatic garbage collection:

• Done todos whose done_at is more than 7 days ago are deleted. A ♻ gc: message is printed to stderr for each removed todo.
• Assigned todos whose assigned_at is more than 7 days ago trigger a ⚠ stale assignment: warning on stderr.

All GC/warning output goes to stderr so it doesn't interfere with piped stdout (e.g. when consumed by a TUI agent).

Files are named <hex>-<slug>.md (e.g. a3f9-fix-the-login-bug.md) and stored in .todo/ relative to the current directory. The hex prefix is the ID used in commands.

Titles are immutable after creation — the filename slug is derived from the title at creation time and is not updated. If a title needs to change, delete the todo and create a new one.

This codebase is 100% vibecoded and intended for personal use.