CLI commands

Global flags on mutating / listing commands:

sprrint --help
sprrint tasks --help

Auth and you

sprrint login --email you@studio.com
sprrint logout
sprrint whoami
sprrint me update --display-name "Ejas" --timezone Asia/Dubai
sprrint keys list
sprrint keys create --name "Laptop" --source cli
sprrint keys revoke 12

Workspaces

Use X-Workspace-Slug automatically when workspace is set in config or SPRRINT_WORKSPACE.

sprrint workspaces list
sprrint workspaces create --name "Nova Studio" --slug nova
sprrint workspaces use acme
sprrint config set workspace acme

Workspace settings

sprrint workspace get
sprrint workspace update --description "Make things."
sprrint workspace invite maya@studio.com --role admin
sprrint workspace role 42 member
sprrint workspace remove 42
sprrint workspace leave
sprrint workspace delete --confirm "Acme Studio"

Projects

sprrint projects list
sprrint projects get BR
sprrint projects create --name "Ops Desk" --key OD
sprrint projects update BR --visibility workspace
sprrint projects archive BR
sprrint projects restore 7
sprrint projects delete BR --confirm "Brand Refresh"
sprrint projects add-member BR maya --role member
sprrint projects remove-member BR 18

The board

sprrint now
sprrint now --assigned me --due overdue
sprrint now --assigned none
sprrint overview
sprrint search "login"
sprrint activity --tab you --range 7

Tasks

sprrint tasks list --sprint launch-week
sprrint tasks get BR-12
sprrint tasks create --title "Ship the CLI" --priority high --tags "cli,mcp" --parent BR-9
sprrint tasks update BR-12 --status progress --assignee maya
sprrint tasks move BR-12 done
sprrint tasks move BR-12 blocked --blocked-note "Waiting on API access"
sprrint tasks move BR-12 done --confirm-complete
sprrint tasks comment BR-12 "Landed."
sprrint tasks attach BR-12 ./brief.pdf

Statuses: todo, progress, blocked, done.
Priority: none, low, medium, high.
Assigned filter: me, any, none (unassigned), or a username.

Sprints

sprrint sprints list --status active
sprrint sprints get launch-week
sprrint sprints create --name "Launch Week" --starts-on 2026-09-01 --ends-on 2026-09-14 --status active --take BR-9,BR-10
sprrint sprints update launch-week --status done
sprrint sprints start launch-week
sprrint sprints pause launch-week
sprrint sprints complete launch-week
sprrint sprints delete launch-week --move free

Black Hole

sprrint blackhole list
sprrint blackhole pull BR-9
sprrint blackhole drop BR-9

pull sends the task to the landing sprint (an active sprint if one exists, otherwise the next planned one).

Categories and files

sprrint categories list
sprrint categories create task Infra
sprrint categories delete 22
sprrint files ./shot.png

Uploaded files return an id you can pass into comments as file_ids via the API.

MCP

sprrint mcp

See ../mcp/README.md.