Commands Reference¶

td's commands are organized by function. Use td <command> --help for detailed options, or td schema for the full machine-readable manifest.

Task Management¶

Command	Description
`td add`	Create a task with project, priority, due date, labels, section
`td quick`	Natural language task creation
`td capture`	Quick-capture to inbox
`td done`	Complete a task
`td undo`	Reopen a completed task
`td edit`	Update task fields
`td move`	Move a task to a different project
`td delete`	Delete a task
`td show`	View full task details
`td search`	Full-text search across all tasks

Workflow¶

Command	Description
`td ls`	List tasks (defaults to today + overdue)
`td today`	Morning dashboard
`td next`	Highest priority task
`td inbox`	Unprocessed inbox tasks
`td focus`	Single-project deep work view
`td log`	Completed tasks
`td review`	Interactive inbox processing TUI

Organization¶

Entity groups for projects, sections, labels, and comments. Each group exposes list, add, edit, delete subcommands (plus archive / unarchive on project). The flat plural forms (td projects, etc.) are permanent shortcuts for the list case. See ADR-0009 for the grammar decision.

Command	Description
`td projects`	List projects
`td project add`	Create a project
`td project edit`	Rename or recolor a project
`td project delete`	Delete a project
`td project archive`	Archive a project
`td project unarchive`	Unarchive a project
`td sections`	List sections
`td section add`	Create a section in a project
`td section edit`	Rename a section
`td section delete`	Delete a section
`td labels`	List labels
`td label add`	Create a label
`td label edit`	Rename or recolor a label
`td label delete`	Delete a label
`td comments`	List comments on a task
`td comment`	Add a comment (flat shortcut)
`td comment add`	Add a comment
`td comment edit`	Update a comment
`td comment delete`	Delete a comment

Utilities¶

Command	Description
`td schema`	Capability manifest (JSON)
`td rate-limit`	API rate limit status
`td init`	Authentication setup
`td completions`	Shell completion scripts

Task References¶

All task commands accept flexible references:

Row number — td done 1 (from the last td ls output)
Content match — td done buy milk (fuzzy match)
Task ID — td done 8bx9a0c2 (exact ID)