CLI & MCP

Waymaker taskboards

Manage taskboards in Commander. Create boards, manage tasks, and organize work with layers and statuses.

TaskboardsProject Management
Last updated: January 21, 2026

Overview

Manage taskboards in Commander. Create boards, manage tasks, and organize work with layers and statuses.

Usage

waymaker taskboards <subcommand> [options]

Subcommands

SubcommandDescription
listList taskboards
getGet taskboard details
createCreate a taskboard
tasksManage tasks
layersManage task layers

List Taskboards

waymaker taskboards list --workspace <workspace-id>

Output:

Taskboards (4)

id           name                  tasks   open    project
----------------------------------------------------------
tb_abc123    Sprint 1              45      12      Product Dev
tb_def456    Marketing Campaigns   28      8       Marketing
tb_ghi789    Customer Support      156     23      Support
tb_jkl012    Q1 Planning           18      5       Leadership

Filter by Project

waymaker taskboards list --workspace ws_xxx --project proj_xxx

JSON Output

waymaker taskboards list --workspace ws_xxx --json
[
  {
    "id": "tb_abc123",
    "name": "Sprint 1",
    "task_count": 45,
    "open_count": 12,
    "project_id": "proj_xxx",
    "workspace_id": "ws_xxx",
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Get Taskboard Details

waymaker taskboards get <taskboard-id>

Output:

Sprint 1

ID: tb_abc123
Workspace: ws_xxx
Project: Product Development
Created: January 1, 2026

Tasks: 45 total
  Backlog: 15
  In Progress: 12
  Review: 8
  Done: 10

Layers: (3)
  - Authentication (12 tasks)
  - API Development (18 tasks)
  - Frontend (15 tasks)

Team: 5 members

JSON Output

waymaker taskboards get tb_abc123 --json

Create Taskboard

waymaker taskboards create \
  --workspace <workspace-id> \
  --name "New Board"

Output:

✓ Taskboard created
ID: tb_new123
Name: New Board
Workspace: ws_xxx

Create in Project

waymaker taskboards create \
  --workspace ws_xxx \
  --project proj_xxx \
  --name "Sprint 2"

Create with Custom Statuses

waymaker taskboards create \
  --workspace ws_xxx \
  --name "Support Queue" \
  --statuses "New,Triaged,In Progress,Waiting,Resolved,Closed"

Manage Tasks

List Tasks

waymaker taskboards tasks <taskboard-id> list

Output:

Tasks: Sprint 1 (45)

id           title                       status        assignee      layer
--------------------------------------------------------------------------
task_001     User login implementation   in_progress   John Smith    Auth
task_002     API endpoint design         review        Jane Doe      API
task_003     Dashboard wireframes        backlog       -             Frontend

Filter by Status

waymaker taskboards tasks tb_abc123 list --status in_progress

Filter by Assignee

waymaker taskboards tasks tb_abc123 list --assignee user_xxx

Filter by Layer

waymaker taskboards tasks tb_abc123 list --layer layer_auth

Get Task Details

waymaker taskboards tasks tb_abc123 get <task-id>

Output:

User login implementation

ID: task_001
Taskboard: Sprint 1
Status: in_progress
Layer: Authentication
Assignee: John Smith
Priority: high
Created: January 15, 2026

Description:
Implement user login with email/password and OAuth support.

Checklist: (3/5)
  ✓ Design login form
  ✓ Implement email/password auth
  ✓ Add OAuth providers
  ☐ Add remember me functionality
  ☐ Write tests

Comments: 3
Attachments: 2

Create Task

waymaker taskboards tasks <taskboard-id> create \
  --title "New Task" \
  --description "Task description"

Output:

✓ Task created
ID: task_new123
Title: New Task
Taskboard: Sprint 1
Status: backlog

Create with Full Details

waymaker taskboards tasks tb_abc123 create \
  --title "API Authentication" \
  --description "Implement JWT authentication" \
  --status backlog \
  --priority high \
  --assignee user_xxx \
  --layer layer_api \
  --due-date "2026-02-01"

Update Task

waymaker taskboards tasks <taskboard-id> update <task-id> \
  --status in_progress \
  --assignee user_xxx

Move Task

waymaker taskboards tasks <taskboard-id> move <task-id> \
  --status done

Delete Task

waymaker taskboards tasks <taskboard-id> delete <task-id>

Manage Layers

List Layers

waymaker taskboards layers <taskboard-id> list

Output:

Layers: Sprint 1 (3)

id           name              tasks   color
--------------------------------------------
layer_001    Authentication    12      blue
layer_002    API Development   18      green
layer_003    Frontend          15      purple

Create Layer

waymaker taskboards layers <taskboard-id> create \
  --name "New Layer" \
  --color blue

Update Layer

waymaker taskboards layers <taskboard-id> update <layer-id> \
  --name "Updated Name" \
  --color green

Delete Layer

waymaker taskboards layers <taskboard-id> delete <layer-id>

Options Reference

list

OptionTypeDescription
--workspacestringRequired. Workspace ID
--projectstringFilter by project
--jsonflagOutput as JSON

get

OptionTypeDescription
--jsonflagOutput as JSON

create

OptionTypeDescription
--workspacestringRequired. Workspace ID
--namestringRequired. Taskboard name
--projectstringProject ID
--statusesstringComma-separated status names

tasks list

OptionTypeDescription
--statusstringFilter by status
--assigneestringFilter by assignee ID
--layerstringFilter by layer ID
--priorityenumFilter by priority
--jsonflagOutput as JSON

tasks create

OptionTypeDescription
--titlestringRequired. Task title
--descriptionstringTask description
--statusstringInitial status
--priorityenumPriority (low, medium, high, urgent)
--assigneestringAssignee user ID
--layerstringLayer ID
--due-datestringDue date (YYYY-MM-DD)

tasks update

OptionTypeDescription
--titlestringNew title
--descriptionstringNew description
--statusstringNew status
--priorityenumNew priority
--assigneestringNew assignee
--layerstringNew layer
--due-datestringNew due date

layers create

OptionTypeDescription
--namestringRequired. Layer name
--colorstringLayer color

AI Agent Workflow

# List all taskboards
BOARDS=$(waymaker taskboards list --workspace ws_xxx --json)

# Get tasks in progress
IN_PROGRESS=$(waymaker taskboards tasks tb_abc123 list --status in_progress --json)

# Count tasks by status
waymaker taskboards get tb_abc123 --json | jq '.task_counts'

# Create tasks from AI-generated breakdown
for task in $(echo $AI_TASKS | jq -c '.[]'); do
  waymaker taskboards tasks tb_abc123 create \
    --title "$(echo $task | jq -r '.title')" \
    --description "$(echo $task | jq -r '.description')" \
    --layer "$(echo $task | jq -r '.layer')"
done

# Update task status based on completion
waymaker taskboards tasks tb_abc123 update task_001 --status done

# Create layer for new feature
waymaker taskboards layers tb_abc123 create \
  --name "$FEATURE_NAME" \
  --color blue

# Get overdue tasks
TODAY=$(date +%Y-%m-%d)
waymaker taskboards tasks tb_abc123 list --json | \
  jq --arg today "$TODAY" '[.[] | select(.due_date < $today and .status != "done")]'