Tasks

Manage your kanban board tasks from the command line.

All task commands support --format json for machine-readable output (default is table).

Kanban Board Model

Tasks in Riven follow a kanban workflow with four status columns:

Status	Description
`scheduled`	Planned for a future sprint or milestone
`queue`	Ready to be picked up
`in-progress`	Actively being worked on
`done`	Completed

Tasks also have a priority (low, medium, high, urgent) and a type (feature, bug, chore, deploy, devops).

riven tasks list

List tasks with optional filters.

bash

# List all tasks
riven tasks list
 
# Filter by status
riven tasks list --status in-progress
 
# Filter by assignee and priority
riven tasks list --assignee user123 --priority high
 
# JSON output
riven tasks list --format json

Option	Values
`--status`	`scheduled`, `queue`, `in-progress`, `done`
`--assignee`	User ID
`--priority`	`low`, `medium`, `high`, `urgent`

riven tasks get

Show full task details including description, metadata, and comments.

bash

riven tasks get TASK-42

riven tasks create

Create a new task on the board.

bash

# Simple task
riven tasks create "Fix login redirect bug"
 
# Full options
riven tasks create "Add rate limiting to API gateway" \
  --description "Implement token bucket rate limiting on all public endpoints" \
  --priority high \
  --type feature \
  --assignee user123 \
  --labels "api,security" \
  --due 2025-04-01

Option	Description
`--description`	Task description
`--priority`	`low`, `medium`, `high`, `urgent`
`--type`	`feature`, `bug`, `chore`, `deploy`, `devops`
`--assignee`	Assignee user ID
`--assignee-name`	Assignee display name
`--labels`	Comma-separated labels
`--due`	Due date (ISO 8601 or natural date)

riven tasks update

Update any field on an existing task.

bash

riven tasks update TASK-42 --priority urgent --status in-progress
riven tasks update TASK-42 --title "Updated title" --labels "api,v2"

riven tasks delete

bash

riven tasks delete TASK-42

riven tasks move

Move a task to a different status column on the board.

bash

riven tasks move TASK-42 in-progress
riven tasks move TASK-42 done

Valid statuses: scheduled, queue, in-progress, done.

riven tasks comment

Add a comment to a task.

bash

riven tasks comment TASK-42 "Deployed to staging, looks good"

Task Lifecycle Example

A typical task lifecycle from creation to completion:

bash

# Create a new task
riven tasks create "Implement user export API" \
  --type feature --priority high --assignee user123
 
# Start working on it
riven tasks move TASK-55 in-progress
 
# Add a progress update
riven tasks comment TASK-55 "Proto definition done, implementing handler"
 
# Mark as complete
riven tasks move TASK-55 done

PreviousPublish NextInternal Docs