Morgen

/Applications/Morgen.app/Contents/MacOS/Morgen --remote-debugging-port=9223
morgen auth

Session auth enables close/reopen on integration tasks (Google Tasks, MS To Do) and AI chat.

Container / Remote CDP

When running inside a Docker container, set CDP_HOST to reach the host:

export CDP_HOST=host.docker.internal   # Docker container → host (port 9223)
morgen auth                            # Extract session token via remote CDP

Container must be started with --add-host=host.docker.internal:host-gateway.

Commands

Tasks

morgen tasks                          # List Morgen-native tasks
morgen tasks --all                    # List from all connected accounts
morgen tasks --account <id>           # List from specific account
morgen tasks get <id>                 # Get task details
morgen tasks create --title "Do X"    # Create task
morgen tasks update <id> --title "Y"  # Update task
morgen tasks close <id>               # Mark complete
morgen tasks reopen <id>              # Reopen completed task
morgen tasks delete <id>              # Delete task
morgen tasks move <id> --after <id>   # Reorder task
morgen tasks schedule <id> --start 2026-02-10T10:00:00  # Schedule on calendar

Options: --title, --description, --due, --duration, --priority (1-9), --tags, --list, --calendar-id

tasks schedule creates a linked task-event on the calendar. The task shows as scheduled in Morgen and can be completed directly from the calendar.

Calendar

morgen calendar                       # List all calendars
morgen calendar events                # Today's events
morgen calendar events --start 2026-02-10 --end 2026-02-11
morgen calendar create --title "Meeting" --start 2026-02-10T14:00:00 --end 2026-02-10T15:00:00
morgen calendar update <event-id> --title "New Title"
morgen calendar delete <event-id>
morgen calendar free --start 2026-02-10T09:00:00 --end 2026-02-10T17:00:00

Options: --calendar-id, --start, --end, --timezone, --location, --attendees, --all-day, --min-minutes

AI Chat

morgen chat "What's on my calendar today?"
morgen chat "Create a task to review the PR"
morgen chat "Find me 2 free hours this week"

The AI assistant has access to calendar and task tools — it can read events, create/update/delete events, list/create/update/close/reopen/delete tasks, and schedule tasks on the calendar with proper task linkage.

Calendar filtering for availability queries:

morgen chat "find free time" --calendars Work,Personal
morgen chat "am I free Friday?" --exclude-calendars Family,Holidays
morgen chat "schedule focus time" --only-primary

Other

morgen accounts                       # Show connected task accounts
morgen auth                           # Authenticate via Morgen app
morgen --json <any command>           # JSON output
morgen --help                         # Full help

Output Formats

morgen tasks --all              # TTY: human-readable lines with colored status
morgen tasks --all --json       # Full JSON array
morgen tasks --all --ndjson     # One JSON object per line (streaming)

Auto-detection: When stdout is piped (not a TTY), the CLI auto-defaults to NDJSON. To force human-readable output in scripts, pipe through cat or use --json and parse.

Closing Integration Tasks (Google Tasks, MS To Do)

Integration task IDs are base64-encoded JSON strings (very long). To close one:

# 1. List tasks as JSON and extract the ID
TASK_ID=$(morgen tasks --all --json | python3 -c "
import sys, json
tasks = json.load(sys.stdin)
for t in tasks:
    if 'keyword' in t.get('title','').lower() and t['progress'] != 'completed':
        print(t['id'])
        break
")

# 2. Close it (the ID must be passed exactly — no truncation)
morgen tasks close "$TASK_ID"

The id field is the only identifier tasks close accepts. Do NOT use legacyId.

Common Workflows

Task Management

# Create and schedule a task
morgen tasks create --title "Review PR" --due 2026-02-12
morgen tasks schedule <task-id> --start 2026-02-11T14:00:00

# Complete a task (use exact id from tasks list)
morgen tasks close <task-id>

# List all tasks including integrations
morgen tasks --all

Calendar Management

# Check today's schedule
morgen calendar events

# Find free time
morgen calendar free --start 2026-02-10T09:00:00 --end 2026-02-10T17:00:00

# Create a meeting
morgen calendar create --title "Team Sync" --start 2026-02-10T15:00:00 --end 2026-02-10T16:00:00

AI Assistant

# Natural language queries
morgen chat "What's my schedule tomorrow?"
morgen chat "Do I have time for a 2-hour meeting this week?"
morgen chat "Create a task to finish the report by Friday"

# With calendar filtering
morgen chat "Am I free Thursday afternoon?" --calendars Work
morgen chat "Find 3 hours of focus time" --exclude-calendars Personal,Family

Development

bun install
bun test                              # Run tests (62 pass)
bun run src/cli.ts <command>          # Run without building