Waymaker goals

Overview

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

Usage

waymaker goals <subcommand> [options]

Subcommands

Subcommand	Description
list	List goals in a workspace
get	Get goal details
create	Create a new goal
update	Update a goal
progress	Update goal progress

List Goals

waymaker goals list --workspace <workspace-id>

Output:

Goals (4)

id           title                        progress   status     due
--------------------------------------------------------------------
goal_abc123  Increase Revenue 20%         65%        on_track   Q1 2026
goal_def456  Launch Mobile App            30%        at_risk    Q1 2026
goal_ghi789  Reduce Churn to <5%          80%        on_track   Q1 2026
goal_jkl012  Expand to EU Market          10%        on_track   Q2 2026

Filter by Period

waymaker goals list --workspace ws_xxx --period "Q1 2026"

Filter by Status

waymaker goals list --workspace ws_xxx --status at_risk

JSON Output

waymaker goals list --workspace ws_xxx --json

[
  {
    "id": "goal_abc123",
    "title": "Increase Revenue 20%",
    "description": "Grow ARR from $1M to $1.2M",
    "progress": 65,
    "status": "on_track",
    "period": "Q1 2026",
    "due_date": "2026-03-31",
    "owner_id": "user_xxx",
    "workspace_id": "ws_xxx"
  }
]

Get Goal Details

waymaker goals get <goal-id>

Output:

Increase Revenue 20%

ID: goal_abc123
Status: on_track
Progress: 65%
Period: Q1 2026
Due: March 31, 2026
Owner: John Smith

Description:
Grow ARR from $1M to $1.2M through expansion and new customers

Key Results:
  1. Close 10 enterprise deals (7/10 complete)
  2. Increase MRR by $50K (75% complete)
  3. Reduce churn to <3% (90% complete)

JSON Output

waymaker goals get goal_abc123 --json

Create Goal

waymaker goals create \
  --workspace <workspace-id> \
  --title "Increase Revenue 20%" \
  --description "Grow ARR from $1M to $1.2M" \
  --period "Q1 2026" \
  --due-date "2026-03-31"

Output:

✓ Goal created
ID: goal_new123
Title: Increase Revenue 20%
Period: Q1 2026

Create with Owner

waymaker goals create \
  --workspace ws_xxx \
  --title "Launch Mobile App" \
  --owner user_xxx \
  --period "Q1 2026"

Update Goal

waymaker goals update <goal-id> \
  --title "Updated Title" \
  --status on_track

Update Status

waymaker goals update goal_abc123 --status at_risk

Status values: on_track, at_risk, off_track, completed

Update Progress

waymaker goals progress <goal-id> --value 75

Output:

✓ Progress updated
Goal: Increase Revenue 20%
Progress: 65% → 75%

Add Note

waymaker goals progress goal_abc123 \
  --value 75 \
  --note "Closed 2 more enterprise deals this week"

Options Reference

list

Option	Type	Description
--workspace	string	Required. Workspace ID
--period	string	Filter by period (e.g., "Q1 2026")
--status	enum	Filter by status
--owner	string	Filter by owner ID
--json	flag	Output as JSON

get

Option	Type	Description
--json	flag	Output as JSON

create

Option	Type	Description
--workspace	string	Required. Workspace ID
--title	string	Required. Goal title
--description	string	Goal description
--period	string	Goal period (e.g., "Q1 2026")
--due-date	string	Due date (YYYY-MM-DD)
--owner	string	Owner user ID

update

Option	Type	Description
--title	string	New title
--description	string	New description
--status	enum	Status (on_track, at_risk, off_track, completed)
--due-date	string	New due date

progress

Option	Type	Description
--value	number	Required. Progress percentage (0-100)
--note	string	Progress update note

AI Agent Workflow

# List at-risk goals
AT_RISK=$(waymaker goals list --workspace ws_xxx --status at_risk --json)

# Update progress programmatically
waymaker goals progress goal_abc123 --value 80 --note "Automated update"

# Create goal from framework output
waymaker goals create \
  --workspace ws_xxx \
  --title "$(echo $OKR_OUTPUT | jq -r '.objective')" \
  --period "Q1 2026"

MCP Tools (Claude Desktop)

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

commander_goal_list

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

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID
goal_type	string	No	Filter: strategic, departmental, team, individual, project
owner_id	string	No	Filter by owner user ID
period	string	No	Filter by period (e.g., "Q1 2026")

Example prompts:

"List all Q1 2026 goals for the organization"

"Show me the Engineering team's OKRs"

"What are Sarah's goals this quarter?"

commander_goal_get

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

Parameters:

Parameter	Type	Required	Description
goal_id	string	Yes	Goal UUID

Example prompts:

"Get the details for goal xyz-123"

"Show me the revenue goal with all its key results"

commander_goal_create

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

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID
title	string	Yes	Goal title
description	string	No	Detailed description
goal_type	string	No	strategic, departmental, team, individual, project
owner_id	string	No	Owner user ID
period	string	No	Time period (e.g., "Q1 2026")
parent_id	string	No	Parent goal ID for cascading

Example prompts:

"Create a goal: 'Increase user retention to 85%' for Q1 2026"

"Create a strategic goal for expanding into the EU market"

"Set up an Engineering team goal for reducing technical debt"

commander_goal_update

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

Parameters:

Parameter	Type	Required	Description
goal_id	string	Yes	Goal UUID
title	string	No	New title
description	string	No	New description
status	string	No	active, completed, archived
progress	number	No	Overall progress (0-100)

Example prompts:

"Mark the revenue goal as completed"

"Update the retention goal progress to 75%"

"Change the mobile app goal status to at_risk"

commander_key_result_create

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

Parameters:

Parameter	Type	Required	Description
goal_id	string	Yes	Parent goal UUID
title	string	Yes	Key result title
target_value	number	Yes	Target value to achieve
current_value	number	No	Starting value (default: 0)
unit	string	No	Unit of measure (%, users, $, etc.)
owner_id	string	No	Owner user ID

Example prompts:

"Add a key result 'Close 10 enterprise deals' with target of 10"

"Create a key result for DAU with target 50000 users"

"Add a key result to track churn rate with target of 3%"

commander_key_result_update

Update a key result's progress or details.

Parameters:

Parameter	Type	Required	Description
key_result_id	string	Yes	Key result UUID
current_value	number	No	New current value
title	string	No	New title
target_value	number	No	New target
status	string	No	active, completed, at_risk

Example prompts:

"Update the enterprise deals key result - we're at 7 now"

"Set the DAU key result to 45000"

"Mark the churn rate key result as completed"

Using Frameworks with Goals

Combine the OKR Builder framework with goal tools for a complete workflow:

"Apply the OKR Builder framework for Q2 Engineering goals, then create the goals in Commander"

This lets Claude analyze your strategy, generate appropriate OKRs, and create them directly in your system.

Related Commands

• frameworks - Use OKR Builder framework
• workspaces - Manage workspaces
• roles - Assign goals to roles