Waymaker folders

Overview

Manage folders in Commander projects. Folders organize documents, sheets, and other files within your projects.

Usage

waymaker folders <subcommand> [options]

Subcommands

Subcommand	Description
list	List folders in a project
create	Create a new folder
move	Move a folder to a new location

List Folders

waymaker folders list --project <project-id>

Output:

Folders (5)

id           name                parent
-----------------------------------------
fold_abc123  Documentation       (root)
fold_def456  Design             (root)
fold_ghi789  Specs              Documentation
fold_jkl012  Wireframes         Design
fold_mno345  Assets             Design

JSON Output

waymaker folders list --project proj_xxx --json

[
  {
    "id": "fold_abc123",
    "name": "Documentation",
    "project_id": "proj_xxx",
    "parent_folder_id": null,
    "created_at": "2026-01-21T08:00:00Z"
  }
]

Create Folder

waymaker folders create \
  --project <project-id> \
  --workspace <workspace-id> \
  --name "New Folder"

Output:

Created folder
ID: fold_new123
Name: New Folder
Project: proj_xxx

Create Nested Folder

waymaker folders create \
  --project proj_xxx \
  --workspace ws_xxx \
  --name "Nested Folder" \
  --parent fold_abc123

Create with Color

waymaker folders create \
  --project proj_xxx \
  --workspace ws_xxx \
  --name "Important Docs" \
  --color "#EF4444"

Options Reference

list

Option	Type	Description
--project	string	Required. Project ID
--json	flag	Output as JSON

create

Option	Type	Description
--project	string	Required. Project ID
--workspace	string	Required. Workspace ID
--name	string	Required. Folder name
--parent	string	Parent folder ID (for nesting)
--color	string	Folder color (hex code)
--icon	string	Folder icon identifier

MCP Tools (Claude Desktop)

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

commander_folder_list

List all folders in a project.

Parameters:

Parameter	Type	Required	Description
project_id	string	Yes	Project UUID

Example prompts:

"List all folders in the Documentation project"

"Show me the folder structure for this project"

commander_folder_get

Get folder details by ID.

Parameters:

Parameter	Type	Required	Description
folder_id	string	Yes	Folder UUID

Example prompts:

"Get details for the Design folder"

"Show me information about folder xyz-123"

commander_folder_create

Create a new folder in a project with optional nesting support.

Parameters:

Parameter	Type	Required	Description
project_id	string	Yes	Project UUID
workspace_id	string	Yes	Workspace UUID
organization_id	string	Yes	Organization UUID
name	string	Yes	Folder name
parent_folder_id	string	No	Parent folder UUID for nesting
color	string	No	Folder color as hex code (e.g., "#3B82F6")
icon	string	No	Folder icon identifier

Example prompts:

"Create a folder called 'Design Documents' in my project"

"Create a nested folder called 'Wireframes' inside the Design folder"

"Create a red folder called 'Urgent' in the project"

commander_folder_update

Update a folder's name, color, icon, or move it to a new parent.

Parameters:

Parameter	Type	Required	Description
folder_id	string	Yes	Folder UUID
name	string	No	New folder name
color	string	No	New color hex code
icon	string	No	New icon name
parent_folder_id	string	No	Move to new parent folder

Example prompts:

"Rename the 'Old Stuff' folder to 'Archive'"

"Change the Design folder color to blue"

"Move the API Docs folder inside Documentation"

commander_folder_delete

Delete a folder. Contents remain in the project but become unorganized.

Parameters:

Parameter	Type	Required	Description
folder_id	string	Yes	Folder UUID

Example prompts:

"Delete the empty 'Temp' folder"

"Remove the old Archive folder"

Organizing Content with Folders

Once you've created folders, you can place documents and sheets directly into them:

Creating documents in folders:

"Create a document called 'API Spec' and place it in the Documentation folder"

Creating sheets in folders:

"Create a spreadsheet called 'Budget Q1' and place it in the Finance folder"

AI Agent Workflow

# List all folders
FOLDERS=$(waymaker folders list --project proj_xxx --json)

# Create a folder structure
waymaker folders create \
  --project proj_xxx \
  --workspace ws_xxx \
  --name "Documentation"

# Get the folder ID and create a nested folder
DOC_FOLDER=$(waymaker folders list --project proj_xxx --json | jq -r '.[] | select(.name=="Documentation") | .id')

waymaker folders create \
  --project proj_xxx \
  --workspace ws_xxx \
  --name "API Docs" \
  --parent "$DOC_FOLDER"

Related Commands

• docs - Create and manage documents
• sheets - Create and manage spreadsheets
• projects - Manage projects
• workspaces - Manage workspaces