CLI & MCP

Command Reference

Learn about Command Reference in WaymakerOS.

CommandsMCP ToolsReference

Complete reference for all Waymaker CLI commands and MCP tools. Use in-page search (Ctrl/Cmd+F) to find any command quickly.


Getting Started

Auth -- login, logout, check status

Manage authentication with Waymaker Commander using secure OAuth 2.1 with PKCE.

CLI: waymaker auth <subcommand>

auth login

Authenticate with Commander via browser OAuth. Opens browser, completes PKCE flow, stores tokens in ~/.waymaker/auth.json.

CLI: waymaker auth login

No parameters.

auth logout

Remove stored credentials. Deletes ~/.waymaker/auth.json.

CLI: waymaker auth logout

No parameters.

auth status

Check current authentication state (user ID, organization, scopes, expiry).

CLI: waymaker auth status

No parameters.


Init -- initialize project connection

Initialize a project directory with Waymaker connection settings. Connects your local directory to a workspace, project, and taskboard in Commander. Creates .commander/config.json.

CLI: waymaker init [options]

OptionTypeDescription
--workspacestringSkip workspace picker, use this ID
--projectstringSkip project picker, use this ID
--taskboardstringSkip taskboard picker, use this ID
--forceflagOverwrite existing configuration

Sync -- bidirectional IDE-Commander synchronization

Bidirectional synchronization between your IDE and Commander. Write markdown files in your IDE, and they automatically sync to Commander as documents with tasks extracted. Trinity Architecture: one markdown file = IDE view + Document view + Task view.

CLI: waymaker sync <subcommand>

waymaker_sync_configure

Configure sync settings for a project directory.

CLI: waymaker sync configure

No parameters (uses .commander/config.json).

waymaker_sync_start

Start the sync daemon. Watches for local file changes and subscribes to Commander taskboard changes in real-time.

CLI: waymaker sync start

OptionTypeDescription
(none)Starts both IDE-to-Commander and Commander-to-IDE sync

waymaker_sync_stop

Stop the sync daemon.

CLI: waymaker sync stop

No parameters.

waymaker_sync_status

Check sync daemon status (running/stopped, files watched, last sync time).

CLI: waymaker sync status

No parameters.

waymaker_sync_poll

Poll for sync changes.

No parameters.

sync all

Immediately sync all matching files.

CLI: waymaker sync all (or waymaker sync-all)

OptionTypeDescription
--dry-runflagPreview changes without syncing
--forceflagRe-sync all files even if unchanged
--batch-sizenumberFiles per batch (default: 50)
--concurrencynumberParallel syncs (default: 5)

Migrate -- import data from other platforms

Migrate data into Waymaker from other platforms. Import contacts, tasks, documents, and other data from common business tools.

CLI: waymaker migrate <source> [options]

Supported sources: notion, asana, trello, monday, airtable, hubspot, salesforce, csv, json

Common Options

OptionTypeDescription
--workspacestringRequired. Target workspace ID
--dry-runflagPreview migration without changes
--verboseflagShow detailed progress
--skip-errorsflagContinue on record errors
--interactiveflagInteractive mapping mode
--jsonflagOutput results as JSON

Notion Options

OptionTypeDescription
--tokenstringRequired. Notion integration token
--databasestringSpecific database ID to migrate

Asana Options

OptionTypeDescription
--tokenstringRequired. Asana personal access token
--projectstringSpecific project GID to migrate

Trello Options

OptionTypeDescription
--api-keystringRequired. Trello API key
--tokenstringRequired. Trello token
--boardstringSpecific board ID to migrate

Airtable Options

OptionTypeDescription
--api-keystringRequired. Airtable API key
--basestringRequired. Base ID to migrate
--tablestringSpecific table to migrate

CSV/JSON Options

OptionTypeDescription
--filestringRequired. Path to import file
--tablestringNew table name
--target-tablestringExisting table ID to import into
--mappingstringColumn mapping as JSON

Workspaces & Projects

Workspaces -- create, list, update, delete workspaces

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

CLI: waymaker workspaces <subcommand>

commander_workspace_list

List all workspaces in an organization.

CLI: waymaker workspaces list

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID

commander_workspace_create

Create a new workspace.

CLI: waymaker workspaces create

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
namestringYesWorkspace name
descriptionstringNoWorkspace description
iconstringNoWorkspace icon
colorstringNoColor hex code (e.g., "#3B82F6")

commander_workspace_update

Update a workspace's settings.

CLI: waymaker workspaces update <workspace-id>

ParameterTypeRequiredDescription
workspace_idstringYesWorkspace UUID
namestringNoNew name
descriptionstringNoNew description
iconstringNoNew icon
colorstringNoNew color

waymaker workspaces get

Get workspace details.

CLI: waymaker workspaces get <workspace-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker workspaces delete

Delete a workspace. Removes all projects and resources within it.

CLI: waymaker workspaces delete <workspace-id>

OptionTypeDescription
--confirmflagRequired for delete operation

waymaker workspaces use

Set default workspace context so you don't need --workspace on every command.

CLI: waymaker workspaces use <workspace-id>

No parameters.


Projects -- create, list, get, update projects

Projects organize work resources like taskboards, documents, and goals within a workspace.

CLI: waymaker projects <subcommand>

commander_project_list

List all projects in a workspace.

CLI: waymaker projects list --workspace <workspace-id>

ParameterTypeRequiredDescription
workspace_idstringYesWorkspace UUID
statusstringNoFilter: active, on_hold, completed, archived

commander_project_get

Get a project by ID with its details.

CLI: waymaker projects get <project-id>

ParameterTypeRequiredDescription
project_idstringYesProject UUID

commander_project_create

Create a new project in a workspace.

CLI: waymaker projects create

ParameterTypeRequiredDescription
workspace_idstringYesWorkspace UUID
namestringYesProject name
descriptionstringNoProject description
iconstringNoProject icon
colorstringNoColor hex code
statusstringNoactive, on_hold, completed, archived

commander_project_update

Update a project's settings.

CLI: waymaker projects update <project-id>

ParameterTypeRequiredDescription
project_idstringYesProject UUID
namestringNoNew name
descriptionstringNoNew description
iconstringNoNew icon
colorstringNoNew color
statusstringNoNew status

Taskboards -- create, list, get taskboards; manage tasks, layers, statuses

Taskboards organize work in Commander with tasks, layers, and custom statuses.

CLI: waymaker taskboards <subcommand>

waymaker taskboards list

List taskboards in a workspace.

CLI: waymaker taskboards list --workspace <workspace-id>

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

waymaker taskboards get

Get taskboard details including task counts, layers, and team.

CLI: waymaker taskboards get <taskboard-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker taskboards create

Create a new taskboard.

CLI: waymaker taskboards create

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

commander_taskboard_tasks

List all tasks in a taskboard (MCP tool).

ParameterTypeRequiredDescription
taskboard_idstringYesTaskboard UUID

Tasks -- create, read, update, delete, assign tasks

Manage individual tasks within taskboards.

CLI: waymaker taskboards tasks <taskboard-id> <subcommand>

commander_task_read

Get task details by ID.

CLI: waymaker taskboards tasks <taskboard-id> get <task-id>

ParameterTypeRequiredDescription
task_idstringYesTask UUID

commander_task_create

Create a new task.

CLI: waymaker taskboards tasks <taskboard-id> 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)

commander_task_update

Update a task's properties.

CLI: waymaker taskboards tasks <taskboard-id> update <task-id>

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

commander_task_delete

Delete a task.

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

ParameterTypeRequiredDescription
task_idstringYesTask UUID

commander_task_assign

Assign a user to a task.

CLI: waymaker taskboards tasks <taskboard-id> assign <task-id> --user <user-id>

ParameterTypeRequiredDescription
task_idstringYesTask UUID
user_idstringYesUser ID to assign

commander_task_list_mine

List tasks assigned to the current user.

No parameters required (uses authenticated user context).


Layers -- create, list, update, delete task layers

Layers group tasks within a taskboard by feature, module, or category.

CLI: waymaker taskboards layers <taskboard-id> <subcommand>

commander_layer_list

List all layers in a taskboard.

CLI: waymaker taskboards layers <taskboard-id> list

ParameterTypeRequiredDescription
taskboard_idstringYesTaskboard UUID

commander_layer_create

Create a new layer.

CLI: waymaker taskboards layers <taskboard-id> create

OptionTypeDescription
--namestringRequired. Layer name
--colorstringLayer color

commander_layer_delete

Delete a layer.

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

ParameterTypeRequiredDescription
layer_idstringYesLayer UUID

Statuses -- list available statuses

List taskboard statuses.

commander_status_list

List all available statuses for a taskboard.

ParameterTypeRequiredDescription
taskboard_idstringYesTaskboard UUID

Comments -- create and list task comments

Manage comments on tasks.

commander_comment_create

Add a comment to a task.

ParameterTypeRequiredDescription
task_idstringYesTask UUID
contentstringYesComment text

commander_comment_list

List comments on a task.

ParameterTypeRequiredDescription
task_idstringYesTask UUID

Documents & Content

Documents -- create, list, get, update documents

Manage documents in Commander workspaces. Documents support rich text JSON and markdown content.

CLI: waymaker docs <subcommand>

commander_document_list

List documents in a workspace with optional filtering.

CLI: waymaker docs list --workspace <workspace-id>

ParameterTypeRequiredDescription
workspace_idstringYesWorkspace UUID
folder_idstringNoFilter to specific folder
limitnumberNoMaximum documents to return (default: 50)
sort_bystringNoSort field: updated_at, created_at, title
sort_orderstringNoasc or desc

commander_document_get

Retrieve a document by ID with its content.

CLI: waymaker docs get <document-id>

ParameterTypeRequiredDescription
document_idstringYesDocument UUID
include_contentbooleanNoInclude full content (default: true)

commander_document_create

Create a new document with content.

CLI: waymaker docs create

ParameterTypeRequiredDescription
workspace_idstringYesWorkspace UUID
titlestringYesDocument title
contentobjectNorich text JSON content structure
text_contentstringNoPlain text or markdown content
document_typestringNogeneral, session-brief, prd, pattern, runbook, api-doc
project_idstringNoProject UUID
folder_idstringNoFolder UUID for placement
statusstringNodraft or published (default: draft)

commander_document_update

Update a document's title, content, status, or location.

CLI: waymaker docs update <document-id>

ParameterTypeRequiredDescription
document_idstringYesDocument UUID
titlestringNoNew document title
contentobjectNoNew rich text JSON content
text_contentstringNoNew plain text or markdown
statusstringNodraft or published
folder_idstringNoMove to folder UUID
project_idstringNoMove to project UUID

Sheets -- create, list, get, update, export spreadsheets

Manage spreadsheets in Commander. Create, read, update, and export sheet data.

CLI: waymaker sheets <subcommand>

commander_sheet_list

List all sheets in an organization.

CLI: waymaker sheets list --workspace <workspace-id>

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID
workspace_idstringNoFilter by workspace
project_idstringNoFilter by project

commander_sheet_get

Retrieve a sheet by ID with optional cell data.

CLI: waymaker sheets get <sheet-id>

ParameterTypeRequiredDescription
sheet_idstringYesSheet UUID
organization_idstringYesOrganization UUID
include_cellsbooleanNoInclude all cell data (default: false)

commander_sheet_create

Create a new spreadsheet with optional initial data.

CLI: waymaker sheets create

ParameterTypeRequiredDescription
workspace_idstringYesWorkspace UUID
organization_idstringYesOrganization UUID
titlestringYesSheet title
descriptionstringNoSheet description
row_countnumberNoNumber of rows (default: 100)
column_countnumberNoNumber of columns (default: 26)
initial_dataarrayNo2D array of initial data
project_idstringNoProject UUID
folder_idstringNoFolder UUID for placement

commander_sheet_update

Update a sheet's metadata or cell values.

CLI: waymaker sheets update <sheet-id>

ParameterTypeRequiredDescription
sheet_idstringYesSheet UUID
organization_idstringYesOrganization UUID
titlestringNoNew sheet title
descriptionstringNoNew description
cellsarrayNoArray of cell updates: [{row, column, value}]

waymaker sheets export

Export sheet to CSV or Excel.

CLI: waymaker sheets export <sheet-id>

OptionTypeDescription
--formatenumExport format (csv, xlsx)
--outputstringRequired. Output file path
--rangestringExport specific range only

Folders -- create, list, get, update, delete folders

Organize documents, sheets, and other files within projects using folders.

CLI: waymaker folders <subcommand>

commander_folder_list

List all folders in a project.

CLI: waymaker folders list --project <project-id>

ParameterTypeRequiredDescription
project_idstringYesProject UUID

commander_folder_get

Get folder details by ID.

CLI: waymaker folders get <folder-id>

ParameterTypeRequiredDescription
folder_idstringYesFolder UUID

commander_folder_create

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

CLI: waymaker folders create

ParameterTypeRequiredDescription
project_idstringYesProject UUID
workspace_idstringYesWorkspace UUID
organization_idstringYesOrganization UUID
namestringYesFolder name
parent_folder_idstringNoParent folder UUID for nesting
colorstringNoFolder color as hex code (e.g., "#3B82F6")
iconstringNoFolder icon identifier

commander_folder_update

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

CLI: waymaker folders update <folder-id>

ParameterTypeRequiredDescription
folder_idstringYesFolder UUID
namestringNoNew folder name
colorstringNoNew color hex code
iconstringNoNew icon name
parent_folder_idstringNoMove to new parent folder

commander_folder_delete

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

CLI: waymaker folders delete <folder-id>

ParameterTypeRequiredDescription
folder_idstringYesFolder UUID

Frameworks -- list, get, apply, search business frameworks

Discover and apply Waymaker's business frameworks. Frameworks are structured methodologies for roles, strategy, goals, and operations.

CLI: waymaker frameworks <subcommand>

commander_framework_list

List available Waymaker Resolute frameworks.

CLI: waymaker frameworks list

ParameterTypeRequiredDescription
categorystringNoFilter by category: strategy, roles, goals, operations, leadership
tierstringNoFilter by tier: starter, pro, enterprise
with_knowledgebooleanNoOnly show frameworks with Resolute book context

commander_framework_get

Get a specific framework with optional Resolute book context.

CLI: waymaker frameworks get <framework-id>

ParameterTypeRequiredDescription
framework_idstringYesFramework ID (e.g., "7-questions", "role-description-builder")
with_contextbooleanNoInclude Resolute book chapter content for AI consumption

commander_framework_apply

Apply a framework to generate structured business content.

CLI: waymaker frameworks apply <framework-id>

ParameterTypeRequiredDescription
framework_idstringYesFramework ID to apply
contextstringYesBusiness context (your situation)
section_inputsobjectNoOptional inputs for specific sections

commander_framework_categories

List framework categories and knowledge sources.

CLI: waymaker frameworks categories

ParameterTypeRequiredDescription
include_sourcesbooleanNoInclude Resolute book information

Search frameworks by keyword.

CLI: waymaker frameworks search "<query>"

OptionTypeDescription
--jsonflagOutput as JSON

waymaker frameworks knowledge

List frameworks with Resolute book context available.

CLI: waymaker frameworks knowledge

OptionTypeDescription
--sourcesflagShow knowledge source details
--jsonflagOutput as JSON

Goals & Organisation

Goals -- create, list, get, update goals and key results

Manage OKRs (Objectives and Key Results) and goals. Create, track, and update organizational goals.

CLI: waymaker goals <subcommand>

commander_goal_list

List all goals/OKRs in an organization with optional filtering.

CLI: waymaker goals list --workspace <workspace-id>

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
goal_typestringNoFilter: strategic, departmental, team, individual, project
owner_idstringNoFilter by owner user ID
periodstringNoFilter by period (e.g., "Q1 2026")

commander_goal_get

Get a goal by ID with its key results and progress.

CLI: waymaker goals get <goal-id>

ParameterTypeRequiredDescription
goal_idstringYesGoal UUID

commander_goal_create

Create a new goal/objective. Goals are the "O" in OKRs.

CLI: waymaker goals create

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
titlestringYesGoal title
descriptionstringNoDetailed description
goal_typestringNostrategic, departmental, team, individual, project
owner_idstringNoOwner user ID
periodstringNoTime period (e.g., "Q1 2026")
parent_idstringNoParent goal ID for cascading

commander_goal_update

Update a goal's details, status, or progress.

CLI: waymaker goals update <goal-id>

ParameterTypeRequiredDescription
goal_idstringYesGoal UUID
titlestringNoNew title
descriptionstringNoNew description
statusstringNoactive, completed, archived
progressnumberNoOverall progress (0-100)

commander_key_result_create

Create a new key result for a goal. Key results are the "KR" in OKRs.

CLI: waymaker goals add-kr <goal-id>

ParameterTypeRequiredDescription
goal_idstringYesParent goal UUID
titlestringYesKey result title
target_valuenumberYesTarget value to achieve
current_valuenumberNoStarting value (default: 0)
unitstringNoUnit of measure (%, users, $, etc.)
owner_idstringNoOwner user ID

commander_key_result_update

Update a key result's progress or details.

CLI: waymaker goals update-kr <key-result-id>

ParameterTypeRequiredDescription
key_result_idstringYesKey result UUID
current_valuenumberNoNew current value
titlestringNoNew title
target_valuenumberNoNew target
statusstringNoactive, completed, at_risk

Roles -- create, list, get, update, assign organizational roles

Manage organizational roles and assignments. Roles define positions with reporting relationships, responsibilities, and accountabilities.

CLI: waymaker roles <subcommand>

commander_role_list

List all roles in an organization.

CLI: waymaker roles list

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
departmentstringNoFilter by department
include_vacantbooleanNoOnly show vacant roles

commander_role_get

Get a role by ID with its accountabilities and assignments.

CLI: waymaker roles get <role-id>

ParameterTypeRequiredDescription
role_idstringYesRole UUID
include_assignmentsbooleanNoInclude user assignments (default: true)

commander_role_create

Create a new role definition.

CLI: waymaker roles create

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
titlestringYesRole title
purposestringNoRole purpose statement
departmentstringNoDepartment name
reports_to_idstringNoUUID of role this reports to
accountabilitiesarrayNoKey accountabilities [{title, description}]

commander_role_update

Update a role's details.

CLI: waymaker roles update <role-id>

ParameterTypeRequiredDescription
role_idstringYesRole UUID
titlestringNoNew title
purposestringNoNew purpose statement
departmentstringNoNew department
reports_to_idstringNoNew reporting role

commander_role_assign

Assign or unassign a user to/from a role.

CLI: waymaker roles assign <role-id> --user <user-id>

ParameterTypeRequiredDescription
role_idstringYesRole UUID
user_idstringYesUser ID to assign/unassign
actionstringNo"assign" or "unassign" (default: assign)
start_datestringNoAssignment start date
allocation_percentagenumberNoTime allocation (0-100)

waymaker roles hierarchy

Show organization chart as a tree.

CLI: waymaker roles hierarchy

OptionTypeDescription
--jsonflagOutput as JSON

Orgs -- view organization profile

View organization information and profile settings. Organizations are the top-level container for all Waymaker resources.

CLI: waymaker orgs <subcommand>

waymaker orgs profile

View organization profile (ID, name, slug, subscription tier, limits).

CLI: waymaker orgs profile

OptionTypeDescription
--jsonflagOutput as JSON

Users -- list, get, invite, remove users

Manage organization users. List users, view profiles, and manage user access.

CLI: waymaker users <subcommand>

commander_user_list

List all users in an organization.

CLI: waymaker users list

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
limitnumberNoMaximum users to return

commander_user_get

Get a user's details.

CLI: waymaker users get <user-id>

ParameterTypeRequiredDescription
user_idstringYesUser ID (Clerk user ID)
organization_idstringNoOrganization context

commander_user_invite

Invite a new user to the organization.

CLI: waymaker users invite

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
emailstringYesEmail address to invite
rolestringNomember or admin (default: member)
team_idsarrayNoTeam IDs to add user to
messagestringNoCustom invitation message

waymaker users remove

Remove a user from the organization.

CLI: waymaker users remove <user-id>

OptionTypeDescription
--forceflagSkip confirmation prompt

Teams -- create, list, get, update teams; manage members

Teams group users for collaboration, permissions, and workspace access.

CLI: waymaker teams <subcommand>

commander_team_list

List all teams in an organization.

CLI: waymaker teams list

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID

commander_team_create

Create a new team.

CLI: waymaker teams create

ParameterTypeRequiredDescription
organization_idstringYesOrganization UUID or Clerk ID
namestringYesTeam name
descriptionstringNoTeam description
lead_user_idstringNoUser ID of team lead

commander_team_add_member

Add users to a team.

CLI: waymaker teams members <team-id> add --user <user-id>

ParameterTypeRequiredDescription
team_idstringYesTeam UUID
user_idsarrayYesArray of user IDs to add
rolestringNoRole: member or lead

commander_team_remove_member

Remove users from a team.

CLI: waymaker teams members <team-id> remove --user <user-id>

ParameterTypeRequiredDescription
team_idstringYesTeam UUID
user_idsarrayYesArray of user IDs to remove

Email & Communication

Email -- send, receive, search, organize emails

Manage email in Commander. Send, receive, search, and organize emails across connected accounts. Includes alias management for multi-domain email routing.

CLI: waymaker email <subcommand>

waymaker email list

List emails with optional filtering.

CLI: waymaker email list

OptionTypeDescription
--folderstringFolder name (inbox, sent, drafts, archive)
--accountstringFilter by email account
--unreadflagShow only unread
--starredflagShow only starred
--limitnumberMaximum results (default: 50)
--jsonflagOutput as JSON

waymaker email get

Get email content.

CLI: waymaker email get <email-id>

OptionTypeDescription
--rawflagGet raw email content
--attachmentsstringDownload attachments to directory
--jsonflagOutput as JSON

waymaker email send

Send an email.

CLI: waymaker email send

OptionTypeDescription
--tostringRequired. Recipient(s), comma-separated
--ccstringCC recipients
--bccstringBCC recipients
--fromstringSender account
--subjectstringRequired. Email subject
--bodystringPlain text body
--htmlstringHTML body
--attachstringFile path to attach (repeatable)

waymaker email reply

Reply to an email.

CLI: waymaker email reply <email-id>

OptionTypeDescription
--bodystringRequired. Reply message
--allflagReply to all recipients

waymaker email forward

Forward an email.

CLI: waymaker email forward <email-id>

OptionTypeDescription
--tostringRequired. Forward recipient
--bodystringRequired. Forward message

waymaker email move

Move email to a folder.

CLI: waymaker email move <email-id>

OptionTypeDescription
--folderstringRequired. Destination folder

Search emails.

CLI: waymaker email search "<query>"

OptionTypeDescription
--fromstringFilter by sender
--tostringFilter by recipient
--subjectstringFilter by subject
--has-attachmentflagHas attachments
--afterstringAfter date (YYYY-MM-DD)
--beforestringBefore date (YYYY-MM-DD)
--limitnumberMaximum results
--jsonflagOutput as JSON

waymaker email aliases list

List aliases for a mailbox.

CLI: waymaker email aliases list --mailbox <mailbox-id>

OptionTypeDescription
--mailboxstringRequired. Mailbox ID to list aliases for
--jsonflagOutput as JSON

waymaker email aliases bulk-add

Bulk add aliases for domain migration.

CLI: waymaker email aliases bulk-add

OptionTypeDescription
--domainstringRequired. Target domain ID (new domain)
--source-domainstringSource domain ID (old domain) for alias creation
--dry-runflagPreview changes without executing
--confirmflagExecute the bulk operation
--jsonflagOutput as JSON

waymaker email aliases bulk-remove

Bulk remove aliases from a domain.

CLI: waymaker email aliases bulk-remove

OptionTypeDescription
--domainstringRequired. Domain ID to remove aliases from
--dry-runflagPreview changes without executing
--confirmflagExecute the bulk operation
--jsonflagOutput as JSON

Domains -- add, verify, remove email domains

Manage email domains for your organization. Configure custom domains, verify DNS settings, and manage domain routing.

CLI: waymaker domains <subcommand>

waymaker domains list

List configured email domains.

CLI: waymaker domains list

OptionTypeDescription
--statusenumFilter by status (active, pending, failed)
--jsonflagOutput as JSON

waymaker domains get

Get domain details including DNS record status.

CLI: waymaker domains get <domain>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker domains add

Add a new email domain. Returns required DNS records.

CLI: waymaker domains add <domain>

OptionTypeDescription
--skip-verificationflagAdd without immediate verification

waymaker domains verify

Verify domain DNS records.

CLI: waymaker domains verify <domain>

OptionTypeDescription
--forceflagForce DNS re-check
--jsonflagOutput as JSON

waymaker domains remove

Remove a domain and disable its email addresses.

CLI: waymaker domains remove <domain>

OptionTypeDescription
--confirmflagConfirm removal without prompt

Shared Inboxes -- create, list, manage shared email inboxes

Manage shared email inboxes for team collaboration. Create shared addresses, manage access, and route incoming emails.

CLI: waymaker shared-inboxes <subcommand>

waymaker shared-inboxes list

List shared inboxes.

CLI: waymaker shared-inboxes list

OptionTypeDescription
--statusenumFilter by status (active, paused)
--jsonflagOutput as JSON

waymaker shared-inboxes get

Get inbox details including statistics and members.

CLI: waymaker shared-inboxes get <inbox-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker shared-inboxes create

Create a shared inbox.

CLI: waymaker shared-inboxes create

OptionTypeDescription
--addressstringRequired. Email address
--namestringRequired. Inbox display name
--membersstringComma-separated user IDs
--auto-assignenumAssignment mode (none, round-robin, load-balanced)
--auto-replystringAuto-reply message

waymaker shared-inboxes update

Update inbox settings.

CLI: waymaker shared-inboxes update <inbox-id>

OptionTypeDescription
--namestringNew inbox name
--auto-assignenumAssignment mode
--auto-replystringAuto-reply message (empty to disable)
--business-hoursstringBusiness hours (HH:MM-HH:MM)
--timezonestringTimezone for business hours
--statusenumInbox status (active, paused)

waymaker shared-inboxes members

Manage inbox members (list, add, remove, change role).

CLI: waymaker shared-inboxes members <inbox-id> <list|add|remove|role>

OptionTypeDescription
--userstringUser ID
--roleenumMember role (admin, member)
--jsonflagOutput as JSON

waymaker shared-inboxes delete

Delete a shared inbox.

CLI: waymaker shared-inboxes delete <inbox-id>

OptionTypeDescription
--confirmflagConfirm deletion

Calendar -- create, list, get, update, delete events

Manage calendar events in Commander. Create, list, and update events across connected calendars.

CLI: waymaker calendar <subcommand>

waymaker calendar list

List calendar events.

CLI: waymaker calendar list

OptionTypeDescription
--fromstringStart date (YYYY-MM-DD)
--tostringEnd date (YYYY-MM-DD)
--calendarstringFilter by calendar
--jsonflagOutput as JSON

waymaker calendar get

Get event details.

CLI: waymaker calendar get <event-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker calendar create

Create a new calendar event.

CLI: waymaker calendar create

OptionTypeDescription
--titlestringRequired. Event title
--startstringRequired. Start time (ISO 8601)
--durationnumberDuration in minutes
--endstringEnd time (alternative to duration)
--attendeesstringComma-separated emails
--locationstringEvent location
--descriptionstringEvent description
--calendarstringTarget calendar
--recurrenceenumRecurrence pattern (daily, weekly, monthly)
--untilstringRecurrence end date
--video-callflagAdd video call link

waymaker calendar update

Update an event.

CLI: waymaker calendar update <event-id>

OptionTypeDescription
--titlestringNew title
--startstringNew start time
--durationnumberNew duration
--locationstringNew location
--descriptionstringNew description
--add-attendeesstringAttendees to add
--remove-attendeesstringAttendees to remove

waymaker calendar delete

Delete a calendar event.

CLI: waymaker calendar delete <event-id>

OptionTypeDescription
--occurrencestringDelete specific occurrence
--all-occurrencesflagDelete all recurring occurrences
--forceflagSkip confirmation

Calls -- list, get, log calls; access recordings

Manage phone calls and call logs in Commander. Access call history, recordings, and transcripts.

CLI: waymaker calls <subcommand>

waymaker calls list

List call history.

CLI: waymaker calls list

OptionTypeDescription
--typeenumFilter by type (incoming, outgoing, missed)
--fromstringStart date (YYYY-MM-DD)
--tostringEnd date (YYYY-MM-DD)
--contactstringFilter by contact name or ID
--limitnumberMaximum results (default: 50)
--jsonflagOutput as JSON

waymaker calls get

Get call details.

CLI: waymaker calls get <call-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker calls log

Log a manual call made outside Commander.

CLI: waymaker calls log

OptionTypeDescription
--phonestringPhone number (required if no contact)
--contactstringContact ID
--typeenumRequired. Call type (incoming, outgoing)
--durationnumberDuration in seconds
--notesstringCall notes
--datestringCall date/time (default: now)

waymaker calls recording

Access call recordings (list, download, transcript).

CLI: waymaker calls recording <list|download|transcript> [call-id]

OptionTypeDescription
--outputstringOutput file path for download
--jsonflagOutput as JSON

Journeys -- create, manage email marketing sequences

Manage email marketing journeys and campaigns. Create automated email sequences, track performance, and manage subscribers.

CLI: waymaker journeys <subcommand>

waymaker journeys list

List journeys.

CLI: waymaker journeys list --workspace <workspace-id>

OptionTypeDescription
--workspacestringRequired. Workspace ID
--statusenumFilter by status (active, paused, draft)
--jsonflagOutput as JSON

waymaker journeys get

Get journey details including steps and statistics.

CLI: waymaker journeys get <journey-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker journeys create

Create a new email journey.

CLI: waymaker journeys create

OptionTypeDescription
--workspacestringRequired. Workspace ID
--namestringRequired. Journey name
--triggerenumRequired. Trigger type (signup, tag, event, date, segment)
--stepsstringInitial steps as JSON array

waymaker journeys add-step

Add a step to a journey.

CLI: waymaker journeys add-step <journey-id>

OptionTypeDescription
--templatestringRequired. Email template ID
--delaystringRequired. Delay before sending (0, 1h, 1d, 1w)
--conditionstringConditional logic
--positionnumberInsert position

waymaker journeys start

Start (activate) a journey.

CLI: waymaker journeys start <journey-id>

No parameters.

waymaker journeys pause

Pause an active journey.

CLI: waymaker journeys pause <journey-id>

No parameters.

waymaker journeys stats

Get journey performance statistics.

CLI: waymaker journeys stats <journey-id>

OptionTypeDescription
--periodstringTime period (7d, 30d, 90d)
--fromstringStart date (YYYY-MM-DD)
--tostringEnd date (YYYY-MM-DD)
--jsonflagOutput as JSON

Automation

Automations -- create, manage workflow automations

Manage workflow automations in Commander. Create triggers, actions, and conditional logic to automate repetitive tasks.

CLI: waymaker automations <subcommand>

waymaker automations list

List automations in a workspace.

CLI: waymaker automations list --workspace <workspace-id>

OptionTypeDescription
--workspacestringRequired. Workspace ID
--statusenumFilter by status (enabled, disabled)
--triggerstringFilter by trigger type
--jsonflagOutput as JSON

waymaker automations get

Get automation details including triggers, conditions, actions, and statistics.

CLI: waymaker automations get <automation-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker automations create

Create a new automation.

CLI: waymaker automations create

OptionTypeDescription
--workspacestringRequired. Workspace ID
--namestringRequired. Automation name
--triggerstringRequired. Trigger type (form_submit, task_created, task_updated, field_change, schedule, webhook, email_received)
--trigger-configstringTrigger configuration JSON
--schedulestringCron expression (for schedule trigger)
--conditionsstringConditions array as JSON
--actionsstringActions array as JSON

waymaker automations add-action

Add an action to an automation.

CLI: waymaker automations add-action <automation-id>

OptionTypeDescription
--typestringRequired. Action type (send_email, create_task, update_record, send_notification, webhook, delay, condition)
--configstringRequired. Action configuration JSON
--positionnumberInsert position

waymaker automations update

Update an automation.

CLI: waymaker automations update <automation-id>

OptionTypeDescription
--namestringAutomation name
--conditionsstringConditions array as JSON

waymaker automations enable

Enable an automation.

CLI: waymaker automations enable <automation-id>

No parameters.

waymaker automations disable

Disable an automation.

CLI: waymaker automations disable <automation-id>

No parameters.

waymaker automations logs

View automation run logs.

CLI: waymaker automations logs <automation-id>

OptionTypeDescription
--statusenumFilter by status (success, failed)
--runstringGet specific run details
--limitnumberMaximum results (default: 50)
--jsonflagOutput as JSON

Connections -- manage third-party service integrations

Manage third-party service connections. Connect Waymaker to external services like Stripe, HubSpot, and Notion using API keys.

CLI: waymaker connections <subcommand>

waymaker connections services

List supported services.

CLI: waymaker connections services

No parameters.

waymaker connections list

List all connections.

CLI: waymaker connections list

OptionTypeDescription
--jsonflagOutput as JSON

waymaker connections create

Create a new connection.

CLI: waymaker connections create

OptionShortTypeDescription
--service-senumRequired. Service name (stripe, hubspot, notion)
--name-nstringRequired. Connection display name
--api-key-kstringRequired. Service API key

waymaker connections get

Get connection details.

CLI: waymaker connections get <connection-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker connections update

Update connection settings.

CLI: waymaker connections update <connection-id>

OptionTypeDescription
--namestringNew display name
--mcp-enabledflagEnable MCP integration
--no-mcp-enabledflagDisable MCP integration

waymaker connections delete

Delete a connection.

CLI: waymaker connections delete <connection-id>

OptionTypeDescription
--confirmflagRequired for delete

waymaker connections test

Test connection validity.

CLI: waymaker connections test <connection-id>

No parameters.

Webhooks -- create and manage incoming webhook connections

Create webhook endpoints that receive data from external services or forms and write rows to Commander tables. No custom code required.

waymaker connections webhook create

Create an incoming webhook connection.

CLI: waymaker connections webhook create

OptionShortTypeDescription
--title-tstringRequired. Webhook name
--workspace-wstringRequired. Workspace ID
--project-pstringProject ID
--tablestringDestination table ID (data lands here)
--descriptionstringDescription
--jsonflagOutput as JSON

Returns the webhook URL: https://apps.waymakerone.com/functions/v1/connection-webhook-receiver?token=whk_xxx

waymaker connections webhook get

Get webhook details including the URL.

CLI: waymaker connections webhook get <connection-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker connections webhook map

Map incoming webhook fields to table columns.

CLI: waymaker connections webhook map <connection-id>

OptionTypeDescription
--tablestringDestination table ID
--fieldsstringField mapping as JSON: '{"name":"name","email":"email"}'

waymaker connections webhook test

Send a test event to a webhook.

CLI: waymaker connections webhook test <connection-id>

OptionTypeDescription
--payloadstringTest payload as JSON

waymaker connections webhook regen

Regenerate webhook token (invalidates old URL).

CLI: waymaker connections webhook regen <connection-id>

No options. Returns the new webhook URL.


Host

Apps -- create, deploy, manage hosted applications

Manage hosted web applications on Waymaker Host. Deploy static sites and frontend apps to Waymaker's global edge network — 330+ cities, sub-50ms latency.

MCP prefix: host_app_*

host_app_list

List all hosted apps in your organization.

ParameterTypeRequiredDescription
workspace_idstringNoFilter by workspace
status_filterstringNo"archived" for archived apps only

host_app_create

Create a new hosted app.

ParameterTypeRequiredDescription
namestringYesApp name (generates URL slug)
descriptionstringNoApp description
workspace_idstringNoAssociate with workspace
repository_urlstringNoGitHub repo URL
repository_branchstringNoBranch to deploy (default: main)
frameworkstringNoFramework preset
build_commandstringNoBuild command
root_dirstringNoRoot dir for monorepos
output_dirstringNoBuild output directory

host_app_get

Get details for a specific app.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

host_app_update

Update app configuration.

ParameterTypeRequiredDescription
app_idstringYesApp UUID
namestringNoNew name
descriptionstringNoNew description
repository_urlstringNoNew repo URL
repository_branchstringNoNew branch
frameworkstringNoFramework preset
build_commandstringNoBuild command
output_dirstringNoOutput directory
custom_domainstringNoCustom domain

host_app_delete

Delete (archive) an app. Creator only.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

host_app_deploy

Trigger a new deployment.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

host_app_deployments

List deployment history.

ParameterTypeRequiredDescription
app_idstringYesApp UUID
limitnumberNoMax results (default: 20)

host_app_upload

Upload files directly to deploy an app (Host Direct). No GitHub required.

ParameterTypeRequiredDescription
app_idstringYesApp UUID
filesarrayYesArray of files to upload

Environment Variables -- manage app and ambassador env vars

Set, list, and delete environment variables for apps and ambassadors.

host_app_env_list

List environment variables for an app.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

host_app_env_set

Set environment variables for an app (merges with existing).

ParameterTypeRequiredDescription
app_idstringYesApp UUID
varsobjectYesKey-value pairs

host_app_env_delete

Delete a single environment variable from an app.

ParameterTypeRequiredDescription
app_idstringYesApp UUID
keystringYesVariable key name

host_ambassador_env_list

List environment variables for an ambassador.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID

host_ambassador_env_set

Set environment variables for an ambassador (merges with existing).

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID
varsobjectYesKey-value pairs

host_ambassador_env_delete

Delete a single environment variable from an ambassador.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID
keystringYesVariable key name

Ambassadors -- create, deploy, manage serverless functions

Manage ambassadors (serverless functions) on Waymaker Host. Deploy to Waymaker's global edge network — 330+ locations worldwide.

MCP prefix: host_ambassador_*

host_ambassador_list

List all ambassadors in your organization.

ParameterTypeRequiredDescription
workspace_idstringNoFilter by workspace
status_filterstringNo"archived" for archived only

host_ambassador_create

Create a new ambassador (serverless function).

ParameterTypeRequiredDescription
namestringYesAmbassador name
descriptionstringNoDescription
workspace_idstringNoAssociate with workspace
repository_urlstringNoGitHub repo URL
repository_branchstringNoBranch (default: main)
function_pathstringNoEntry file (default: index.ts)
auth_modestringNorequired, public, api-key
schedulestringNoCron expression

host_ambassador_get

Get details for a specific ambassador.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID

host_ambassador_deploy

Trigger a deployment via GitHub Actions build runner.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID

host_ambassador_invoke

Manually invoke a deployed ambassador.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID

host_ambassador_logs

Get invocation history.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID
limitnumberNoMax results (default: 50, max: 200)
offsetnumberNoPagination offset

host_ambassador_delete

Delete (archive) an ambassador and remove the serverless function. Creator only.

ParameterTypeRequiredDescription
ambassador_idstringYesAmbassador UUID

Host Domains -- setup, verify, manage custom domains for apps

Manage custom domains for hosted apps. Setup DNS, verify records, and provision SSL.

MCP prefix: host_domain_*

host_domain_setup

Initiate custom domain setup. Returns DNS records to configure.

ParameterTypeRequiredDescription
app_idstringYesApp UUID
domainstringYesCustom domain name

host_domain_verify

Verify DNS records and auto-provision SSL. Rate limited to 60s per app.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

host_domain_status

Check current domain verification status.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

host_domain_remove

Remove custom domain and clean up SSL.

ParameterTypeRequiredDescription
app_idstringYesApp UUID

GitHub -- connect, disconnect, check GitHub installations

Manage GitHub App installations linked to your organization for automated deployments.

MCP prefix: host_github_*

host_github_status

List GitHub App installations linked to your organization.

No parameters required.

host_github_connect

Link a GitHub App installation to your organization.

ParameterTypeRequiredDescription
installation_idnumberYesGitHub installation ID

host_github_disconnect

Remove a GitHub App installation link.

ParameterTypeRequiredDescription
installation_idnumberYesGitHub installation ID

Tables & Forms

Tables -- create, query, manage structured data tables

Manage data tables in Commander. Create structured databases, query records, and integrate with other tools.

CLI: waymaker tables <subcommand>

waymaker tables list

List tables in a workspace.

CLI: waymaker tables list --workspace <workspace-id>

OptionTypeDescription
--workspacestringRequired. Workspace ID
--jsonflagOutput as JSON

waymaker tables get

Get table schema and field definitions.

CLI: waymaker tables get <table-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker tables create

Create a new table with optional inline columns or schema file.

CLI: waymaker tables create "<name>"

OptionTypeDescription
--workspacestringRequired. Workspace ID
--projectstringProject ID (required for table to appear in Explorer)
--namestringRequired. Table name
--columnsstringInline column spec (e.g., "name:text!,status:select[A,B]")
--schemastringSchema file path (JSON)
--fieldsstringInitial fields as JSON array

Column spec format: name:type[options]! where ! marks required. For select types, options go inside brackets.

waymaker tables enable-webhook

Enable a webhook receiver on a table so external forms or services can POST data directly as new rows.

CLI: waymaker tables enable-webhook <table-id>

No additional options. Generates a token automatically and prints the full webhook URL.

waymaker tables records list

List records in a table.

CLI: waymaker tables records <table-id> list

OptionTypeDescription
--jsonflagOutput as JSON

waymaker tables records get

Get a single record.

CLI: waymaker tables records <table-id> get <record-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker tables records create

Create a record (single or bulk).

CLI: waymaker tables records <table-id> create

OptionTypeDescription
--datastringRecord data as JSON
--filestringImport from JSON file
--bulkflagBulk import mode

waymaker tables records update

Update a record.

CLI: waymaker tables records <table-id> update <record-id>

OptionTypeDescription
--datastringRecord data as JSON

waymaker tables records delete

Delete a record.

CLI: waymaker tables records <table-id> delete <record-id>

No additional options.

waymaker tables fields add

Add a field to a table.

CLI: waymaker tables fields add <table-id>

OptionTypeDescription
--namestringRequired. Field name
--typestringRequired. Field type
--requiredflagMake field required
--uniqueflagEnforce uniqueness
--optionsstringOptions for select types (comma-separated)
--link-tablestringTarget table for link type

Supported field types: text, longtext, number, currency, percent, email, phone, url, select, multiselect, checkbox, date, datetime, user, link, attachment, formula

waymaker tables fields update

Update a field.

CLI: waymaker tables fields update <table-id> <field-name>

OptionTypeDescription
--namestringNew field name

waymaker tables fields delete

Delete a field.

CLI: waymaker tables fields delete <table-id> <field-name>

No additional options.

waymaker tables query

Query table data with filters, sorting, and pagination.

CLI: waymaker tables query <table-id>

OptionTypeDescription
--filterstringRequired. Filter as JSON
--sortstringSort order (field:asc/desc)
--fieldsstringComma-separated field names
--limitnumberMaximum results
--offsetnumberSkip records
--jsonflagOutput as JSON

Forms -- create, manage forms and submissions

Manage forms in Commander. Create forms, collect submissions, and integrate with tables and automations.

CLI: waymaker forms <subcommand>

waymaker forms list

List forms in a workspace.

CLI: waymaker forms list --workspace <workspace-id>

OptionTypeDescription
--workspacestringRequired. Workspace ID
--statusenumFilter by status (published, draft)
--jsonflagOutput as JSON

waymaker forms get

Get form details including fields and settings.

CLI: waymaker forms get <form-id>

OptionTypeDescription
--jsonflagOutput as JSON

waymaker forms create

Create a new form.

CLI: waymaker forms create

OptionTypeDescription
--workspacestringRequired. Workspace ID
--namestringRequired. Form name
--fieldsstringFields as JSON array
--tablestringLink to table for submissions

waymaker forms add-field

Add a field to a form.

CLI: waymaker forms add-field <form-id>

OptionTypeDescription
--namestringRequired. Field name
--typestringRequired. Field type (text, textarea, email, phone, number, select, radio, checkbox, date, file, hidden)
--labelstringDisplay label
--requiredflagMake field required
--optionsstringOptions for select/radio
--placeholderstringPlaceholder text
--positionnumberField position

waymaker forms update

Update form settings.

CLI: waymaker forms update <form-id>

OptionTypeDescription
--namestringForm name
--redirect-urlstringPost-submission redirect
--notification-emailstringNotification recipient
--success-messagestringSuccess message

waymaker forms submissions

View form submissions.

CLI: waymaker forms submissions <form-id>

OptionTypeDescription
--fromstringStart date (YYYY-MM-DD)
--tostringEnd date (YYYY-MM-DD)
--submissionstringGet specific submission
--exportenumExport format (csv, json)
--outputstringExport file path
--limitnumberMaximum results
--jsonflagOutput as JSON

waymaker forms publish

Publish a form (makes it publicly accessible).

CLI: waymaker forms publish <form-id>

No parameters.

waymaker forms unpublish

Unpublish a form.

CLI: waymaker forms unpublish <form-id>

No parameters.


Search -- search across all Commander resources

Search across all Commander resources.

Full-text search across workspaces, projects, documents, tasks, and more.

ParameterTypeRequiredDescription
querystringYesSearch query
organization_idstringYesOrganization UUID

MyVault — your second brain (notes & files)

MyVault is your personal space for notes and files — markdown notes plus any file you want to keep alongside them. Notes stay versioned; large files are stored securely and referenced from your vault, so a 2 KB note and a 500 MB video are equally at home. See the vault command article.

Vault -- upload files of any size

Put a file of any size into your vault from the terminal. The file uploads directly to secure storage and is referenced from your vault, so there is no size limit beyond your storage quota.

CLI: waymaker vault add <file> [options]

vault add

Upload a file to your vault.

OptionTypeDescription
--path <vaultPath>stringDestination path in the vault. Default: attachments/<filename>
waymaker vault add ./brand-deck.pdf
waymaker vault add ./Q3-report.pdf --path "reports/2026/Q3-report.pdf"

MyVault MCP tools

Your AI assistant can manage vault files directly (no CLI needed):

commander_vault_attach

Attach a smaller file (image, PDF, document) by passing its contents or an https URL. Best for files up to ~25 MB; for larger files use the upload tools below.

ParameterTypeRequiredDescription
vault_pathstringYesWhere the file belongs (e.g. attachments/photo.png)
content_typestringYesMIME type, e.g. application/pdf
file_sourcestringYesbase64 or url
file_contentstringYesThe base64 bytes, or an https URL to fetch

commander_vault_upload_init / commander_vault_upload_complete

Two-step upload for any size file. init returns a one-time upload URL; the client uploads the bytes directly; complete files the reference into the vault. This is how an AI agent (or the CLI) adds a large file without the bytes passing through Waymaker.

Parameter (init)TypeRequiredDescription
vault_pathstringYesWhere the file belongs (e.g. attachments/deck.pdf)
content_typestringYesMIME type
size_bytesnumberYesExact file size in bytes

commander_vault_attach_get

Get a short-lived download link for a file in your vault.

ParameterTypeRequiredDescription
vault_pathstringYesPath to the file (e.g. attachments/photo.png)

commander_vault_delete

Delete a file from your vault.

ParameterTypeRequiredDescription
vault_pathstringYesPath to the file to remove

Markdown notes are managed with the commander_notes_* tools (create, read, update, delete, search, history) and the vault setup tools (commander_notes_vault_init, commander_notes_vault_status, commander_notes_vault_clone_token for IDE access).