Waymaker projects

Overview

Manage projects within workspaces. Projects organize work resources like taskboards, documents, and goals.

Usage

waymaker projects <subcommand> [options]

Subcommands

Subcommand	Description
list	List projects in a workspace
get	Get project details
create	Create a new project

List Projects

waymaker projects list --workspace <workspace-id>

Output:

Projects in Workspace (3)

id           name              status   taskboards   members
------------------------------------------------------------
proj_abc123  Q1 Planning       active   2            5
proj_def456  Product Launch    active   4            8
proj_ghi789  Documentation     active   1            3

JSON Output

waymaker projects list --workspace ws_xxx --json

[
  {
    "id": "proj_abc123",
    "name": "Q1 Planning",
    "description": "Q1 2026 planning project",
    "status": "active",
    "workspace_id": "ws_xxx",
    "created_at": "2026-01-15T10:00:00Z"
  }
]

Get Project Details

waymaker projects get <project-id>

Output:

Q1 Planning

ID: proj_abc123
Workspace: ws_xxx
Status: active
Created: January 15, 2026

Description:
Q1 2026 planning project for all departments

Resources:
  Taskboards: 2
  Documents: 15
  Goals: 4

Create Project

waymaker projects create \
  --workspace <workspace-id> \
  --name "New Project" \
  --description "Project description"

Output:

✓ Project created
ID: proj_new123
Name: New Project
Workspace: ws_xxx

Options Reference

list

Option	Type	Description
--workspace	string	Required. Workspace ID
--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. Project name
--description	string	Project description

AI Agent Workflow

# List projects
PROJECTS=$(waymaker projects list --workspace ws_xxx --json)

# Get first project ID
PROJECT_ID=$(echo $PROJECTS | jq -r '.[0].id')

# Get project details
waymaker projects get $PROJECT_ID --json

MCP Tools (Claude Desktop)

When using the Waymaker MCP server with Claude Desktop or other AI assistants, these tools are available:

commander_project_list

List all projects in a workspace.

Parameters:

Parameter	Type	Required	Description
workspace_id	string	Yes	Workspace UUID
status	string	No	Filter: active, on_hold, completed, archived

Example prompts:

"List all projects in the Marketing workspace"

"Show me active projects"

"What projects are on hold?"

commander_project_get

Get a project by ID with its details.

Parameters:

Parameter	Type	Required	Description
project_id	string	Yes	Project UUID

Example prompts:

"Get details for the Website Redesign project"

"Show me project xyz-123"

commander_project_create

Create a new project in a workspace.

Parameters:

Parameter	Type	Required	Description
workspace_id	string	Yes	Workspace UUID
name	string	Yes	Project name
description	string	No	Project description
icon	string	No	Project icon
color	string	No	Color hex code
status	string	No	active, on_hold, completed, archived

Example prompts:

"Create a project called 'Website Redesign' in the Marketing workspace"

"Create a new project for Q1 Planning"

"Set up a project called 'API Integration' with a blue color"

commander_project_update

Update a project's settings.

Parameters:

Parameter	Type	Required	Description
project_id	string	Yes	Project UUID
name	string	No	New name
description	string	No	New description
icon	string	No	New icon
color	string	No	New color
status	string	No	New status

Example prompts:

"Archive the 'Old Website' project"

"Change the Q1 Planning project status to completed"

"Rename the project to 'Phase 2 Development'"

Related Commands

• workspaces - Manage workspaces
• taskboards - Manage taskboards within projects
• sync - Sync IDE files to projects