Skip to content

CLI reference: tasks

To-dos (VTODO) on your task-capable calendars — a surface parallel to calendar events. Part of the CLI reference.

CommandWhat it does
tasks listList tasks (incomplete by default; --all includes completed, --cal, --limit)
tasks search [query]Search tasks across all fields (title, notes, location, categories, status, due)
tasks create --titleCreate a task (--due, --start, --priority high|normal|low, --notes, --location, --category, --status, --percent, --recur, --reminder, --attach, --cal)
tasks update <id>Update a task (only the flags you pass change; empty value clears)
tasks complete <id>Mark a task done (--reopen sets it back to needs-action)
tasks delete <id>Delete a task by id
Terminal window
atbridge tasks create --title "Follow up with Sam" --due 2026-07-03T17:00 --priority high
atbridge tasks list --pretty
atbridge tasks complete <id>

Was this page helpful?