@waymakeros/cli

Your entire business context, available to every AI agent.

Waymaker CLI connects your development environment to Commander — enabling bidirectional sync between your IDE and your team's task management.

Features

- OAuth Authentication — Secure login via browser
- Bidirectional Sync — Changes flow both ways between IDE and Commander
- MCP Server Mode — Works with Claude Code, Cursor, and other AI assistants
- Terminal Kanban — View your taskboard without leaving the terminal

Installation

``bash
npm install -g @waymakeros/cli
`

Requires Node.js 18+

Quick Start

$3

`bash
waymaker auth login
`

Opens your browser for secure OAuth login.

$3

`bash
cd your-project
waymaker init
`

Select your workspace, project, and taskboard.

$3

`bash
waymaker sync start
`

Now changes sync bidirectionally:
- Edit markdown tasks in your IDE → updates Commander
- Move cards in Commander → updates your local files

Commands

| Command | Description |
|---------|-------------|
| waymaker auth login | Authenticate via browser |
| waymaker auth logout | Remove stored credentials |
| waymaker auth status | Check authentication state |
| waymaker init | Initialize project with workspace/taskboard |
| waymaker sync start | Start bidirectional sync daemon |
| waymaker sync stop | Stop sync daemon |
| waymaker sync status | Check sync daemon status |
| waymaker sync all | Sync all files immediately |
| waymaker kanban | Display terminal kanban board |
| waymaker serve | Start MCP server for AI assistants |

MCP Server Mode

For AI assistants like Claude Code or Cursor:

`bash
waymaker serve
`

$3

Add to your Claude Code settings:

`json
{
"mcpServers": {
"waymaker": {
"command": "waymaker",
"args": ["serve"]
}
}
}
`

$3

- waymaker_sync_status — Check sync daemon health
- waymaker_sync_start — Start sync daemon
- waymaker_sync_stop — Stop sync daemon
- waymaker_kanban_view — View taskboard in terminal
- waymaker_create_task — Create new task
- waymaker_update_task — Update task status/details
- waymaker_list_tasks — List tasks from taskboard

File Format

Tasks are stored as markdown with YAML frontmatter:

`markdown
---
sync:
type: task
status: active
task_id: abc-123
title: "Implement feature X"
status: "in_progress"
priority: "high"
---

Implement feature X

Task description here...

Notes

_Your notes_
`

Configuration

$3

Stored in .commander/config.json:

`json
{
"workspace_id": "uuid",
"project_id": "uuid",
"taskboard_id": "uuid",
"sync": {
"enabled": true,
"mode": "bidirectional"
}
}
`

$3

Stored in ~/.waymaker/auth.json` (auto-managed)

Requirements

- Node.js 18+
- Commander account at commander.waymakerone.com

Links

- Commander — Task management
- Help Center — Documentation
- Waymaker — Platform home

License

MIT