Task lifecycle

Create and inspect work

bean add "Add retry handling to the sync client"
bean list
bean list --status pending
bean list --by-project

Use --project <selector> when the current directory is not enough to identify the target Project.

bean start 1
bean block 1
bean edit 1 --notes "Waiting for the API contract"
bean done 1

Task statuses are pending, in_progress, blocked, and done.

bean edit 1 --due-date 2026-08-01
bean remind "Review the retry policy" "tomorrow at 9am"

bean remind <title> <when> creates a new pending Task with that reminder. It does not add a reminder to an existing Task ID.

bean edit 1 --title "Update the sync client retry policy"
bean remove 1

Most task commands support --json for agents and scripts. Use JSON when another process needs to consume the result.