Waymaker workspaces

Overview

Manage Waymaker workspaces. Workspaces are top-level containers that organize your projects, teams, and resources.

Usage

waymaker workspaces <subcommand> [options]

Subcommands

Subcommand	Description
list	List all workspaces
create	Create a new workspace
get	Get workspace details
update	Update workspace properties
delete	Delete a workspace
use	Set default workspace context

Examples

List All Workspaces

waymaker workspaces list

Output:

id                                    name                 description                          created
----------------------------------------------------------------------------------------------------------
c1d36c8f-42b6-4011-8ac9-1244fb1f8e56  Selah Valley Estate  Client work on Selah Valley Estate   1/20/2026
cd95b528-b5be-4d35-9b7e-1bbea4bceaf1  Product              Product management                   12/12/2025
17eb16bb-1dda-42e9-9963-9df215343872  My Workspace         Personal workspace                   12/11/2025

Create a Workspace

waymaker workspaces create --name "Q1 Planning" --description "Q1 2026 strategic planning"

Output:

✓ Workspace created
ID: a1b2c3d4-...
Name: Q1 Planning

Get Workspace Details

waymaker workspaces get c1d36c8f-42b6-4011-8ac9-1244fb1f8e56

Set Default Workspace

waymaker workspaces use cd95b528-b5be-4d35-9b7e-1bbea4bceaf1

This sets the workspace context for subsequent commands, so you don't need to specify --workspace each time.

Delete a Workspace

waymaker workspaces delete a1b2c3d4-... --confirm

Warning: Deleting a workspace removes all projects and resources within it.

Options

Option	Type	Description
--name	string	Workspace name
--description	string	Workspace description
--json	flag	Output as JSON
--confirm	flag	Required for delete operation

JSON Output

waymaker workspaces list --json

[
  {
    "id": "c1d36c8f-42b6-4011-8ac9-1244fb1f8e56",
    "name": "Selah Valley Estate",
    "description": "Client work on Selah Valley Estate",
    "created": "1/20/2026"
  }
]

Use Cases

Partner Implementation Setup

# Create client workspace
waymaker workspaces create --name "Client: Acme Corp" --description "Acme Corp implementation"

# Set as default
waymaker workspaces use <workspace-id>

# Create projects within
waymaker projects create --name "Phase 1: Setup"
waymaker projects create --name "Phase 2: Migration"

AI Agent Workflow

# List workspaces in JSON
WORKSPACES=$(waymaker workspaces list --json)

# Parse with jq to get first workspace ID
WORKSPACE_ID=$(echo $WORKSPACES | jq -r '.[0].id')

# Use in subsequent commands
waymaker projects list --workspace $WORKSPACE_ID --json

MCP Tools (Claude Desktop)

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

commander_workspace_list

List all workspaces in an organization.

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID

Example prompts:

"List all workspaces in my organization"

"Show me available workspaces"

commander_workspace_create

Create a new workspace.

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID
name	string	Yes	Workspace name
description	string	No	Workspace description
icon	string	No	Workspace icon
color	string	No	Color hex code (e.g., "#3B82F6")

Example prompts:

"Create a workspace called 'Q2 Marketing Campaign'"

"Create a new workspace for the Product team with a blue color"

"Set up a workspace called 'Client: Acme Corp' for our new client"

commander_workspace_update

Update a workspace's settings.

Parameters:

Parameter	Type	Required	Description
workspace_id	string	Yes	Workspace UUID
name	string	No	New name
description	string	No	New description
icon	string	No	New icon
color	string	No	New color

Example prompts:

"Rename the Marketing workspace to 'Marketing 2026'"

"Update the Product workspace description"

"Change the Engineering workspace color to green"

Related Commands

• projects - Manage projects within workspaces
• auth context - View current workspace context