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
| Subcommand | Description |
|---|---|
list | List taskboards |
get | Get taskboard details |
create | Create a taskboard |
tasks | Manage tasks |
layers | Manage 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
| Option | Type | Description |
|---|---|---|
--workspace | string | Required. Workspace ID |
--project | string | Filter by project |
--json | flag | Output as JSON |
get
| Option | Type | Description |
|---|---|---|
--json | flag | Output as JSON |
create
| Option | Type | Description |
|---|---|---|
--workspace | string | Required. Workspace ID |
--name | string | Required. Taskboard name |
--project | string | Project ID |
--statuses | string | Comma-separated status names |
tasks list
| Option | Type | Description |
|---|---|---|
--status | string | Filter by status |
--assignee | string | Filter by assignee ID |
--layer | string | Filter by layer ID |
--priority | enum | Filter by priority |
--json | flag | Output as JSON |
tasks create
| Option | Type | Description |
|---|---|---|
--title | string | Required. Task title |
--description | string | Task description |
--status | string | Initial status |
--priority | enum | Priority (low, medium, high, urgent) |
--assignee | string | Assignee user ID |
--layer | string | Layer ID |
--due-date | string | Due date (YYYY-MM-DD) |
tasks update
| Option | Type | Description |
|---|---|---|
--title | string | New title |
--description | string | New description |
--status | string | New status |
--priority | enum | New priority |
--assignee | string | New assignee |
--layer | string | New layer |
--due-date | string | New due date |
layers create
| Option | Type | Description |
|---|---|---|
--name | string | Required. Layer name |
--color | string | Layer 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")]'
Related Commands
- projects - Project management
- sync - Sync IDE files to taskboards
- goals - Link tasks to goals
- automations - Task-triggered automations