@goalswon/cli

Manage your GoalsWon goals, targets, and chat from the terminal.

Install

npm install -g @goalswon/cli

Or run directly:

npx @goalswon/cli

Setup

1. Get an API key at app.goalswon.com > Settings > API Access
2. Login:

   goalswon auth login YOUR_API_KEY

Commands

Auth

goalswon auth login <key>     # Save API key
goalswon auth status          # Check who you're logged in as
goalswon auth config          # Show config path and API URL
goalswon health               # Check API connectivity

Goals

goalswon goals list --today                    # Today's goals
goalswon goals list --yesterday                # Yesterday's goals
goalswon goals list --tomorrow                 # Tomorrow's goals
goalswon goals list --date 2026-03-27          # Specific date
goalswon goals list --status done              # Filter by status
goalswon goals create "Exercise" --today --tag 2
goalswon goals create "Plan week" --tomorrow
goalswon goals create "Done task" --today --status done  # Create as already completed
goalswon goals complete <id>                   # Mark as done
goalswon goals complete <id> --status partial  # Mark as partial
goalswon goals complete recurring_abc --date 2026-03-26  # Complete recurring goal on a specific day
goalswon goals delete <id>
goalswon goals recurring                       # List recurring templates

Days

goalswon days list                             # Recent days
goalswon days list --from 2026-03-01 --to 2026-03-31
goalswon days show --today                     # Today's detail with goals
goalswon days show --yesterday                 # Yesterday
goalswon days show 20260327                    # Specific date

Targets

goalswon targets list --month 202603           # March targets
goalswon targets create "Read 3 books" --month 202603

Chat

goalswon chat list                             # Recent messages
goalswon chat list --search "meeting"          # Search
goalswon chat send "Hello!" --client <id>      # Send (coaches)

Clients (coaches only)

goalswon clients list                          # All clients
goalswon clients list --type premium           # Filter by type
goalswon clients summary <id>                  # Full client summary

Progress

goalswon progress                              # Last 30 days
goalswon progress --from 2026-01-01 --to 2026-03-31

JSON Output

Add --json to any command to get machine-readable output — great for agents, scripts, and piping to jq:

goalswon goals list --date 2026-04-14 --json
goalswon clients list --json | jq '.[].name'
goalswon days show 20260414 --json

Set JSON as your default (persists across sessions):

goalswon config set json true   # always output JSON
goalswon config set json false  # back to human-readable

Rules:

• stdout: JSON data only
• stderr: status messages, warnings, progress hints
• Exit codes: unchanged (0 = success, non-zero = error)
• Errors also output as JSON: {"error": "message"}

License

MIT