pavel 1ar.ionov

craft-cli 0.5.0: every task, one command

craft-cli now finds every task across a Craft space by default, with composable filters for documents, dates, state, reminders, priority, location, and text.

1 min read
craft-cli 0.5.0: every task, one command

craft-cli 0.5.0 is out. Release on GitHub.

craft tasks now returns tasks from the whole Craft space by default, including unscheduled tasks inside documents. The command uses Craft’s space-wide task scope and applies filters locally after one API call, so agents can narrow the same complete result without scanning documents one by one.

Explore tasks

craft tasks
craft tasks --state todo --document "Project" --deadline-to tomorrow
craft tasks --doc <documentId> --scheduled none --reminder no --json
craft tasks --date today --location daily --text "report" --limit 20
craft tasks --repeat yes --notification yes

Filters cover task state, document ID or title, location, text, scheduled dates, deadlines, overdue tasks, repeating tasks, reminders or notifications, priority when present in Craft’s payload, and result limits. Dates accept ISO dates plus today, yesterday, and tomorrow.

Task updates can also move a task and clear scheduled dates or deadlines:

craft tasks update <taskId> --to doc --doc <documentId>
craft tasks update <taskId> --schedule none --deadline tomorrow

The bundled agent skill, command help, and JSON output contract have been updated with the same task explorer workflow.

Upgrade

cd ~/dev/tools/craft-cli
git pull
./install.sh
craft tasks --state todo