Stuff CLI

Stuff CLI lets you work with your Stuff data from Terminal on Mac. It is included with Stuff for Mac and available with Extra Stuff. Install it from Settings → Command Line in Stuff for Mac: copy the install command, run it in Terminal, then check that everything is ready with stuff doctor.

Use the CLI to create and organize Tasks, Lists, Headings, and Spaces; find work; update metadata and status; and archive, restore, or trash items. Commands use an item ID or an exact, unique name. Start with stuff help or stuff help <command> to see every option. Add --json when another tool needs machine-readable results, and add --dry-run to supported changes to preview them before Stuff writes anything.

Examples

# See what is planned for today
stuff tasks list --view today --limit 10

# Add a Task with a Plan and Tag
stuff add "Send project update" --plan 2026-09-14 --tag Work

# Find a Task, then update its Deadline
stuff search "project update" --type task
stuff edit task "Send project update" --deadline 2026-09-18

# Complete it, or preview a change first
stuff complete "Send project update"
stuff edit task "Send project update" --someday --dry-run

The CLI works especially well with agents: ask an agent to inspect your Tasks, prepare a summary, or make a specific change through the commands above. Review the command and its results before using it for a change you would not want to undo.