Exponential CLI Skill

Exponential is an AI-native productivity platform. This skill uses the exponential CLI to manage actions (tasks), projects, and workspaces.

Prerequisites

npm install -g exponential-cli
exponential auth login --token <JWT> --api-url https://www.exponential.im

Verify: exponential --help should show available commands.

Commands

Actions (Tasks)

List actions:

exponential actions list [--project <id>] [--status <BACKLOG|TODO|IN_PROGRESS|IN_REVIEW|DONE>] [--assignee <id>]

Today's actions:

exponential actions today [--workspace <id>]

Date range:

exponential actions range --start 2026-01-01 --end 2026-01-31 [--workspace <id>]

Kanban board:

exponential actions kanban [--project <id>] [--status <status>] [--assignee <id>]

Create action:

exponential actions create -n "Task name" [-d "Description"] [-p <projectId>] [--priority "1st Priority"] [--due 2026-03-01] [--effort 60]

Update action:

exponential actions update --id <actionId> [-n "New name"] [-d "New desc"] [-p <projectId>] [--priority "2nd Priority"] [--status COMPLETED] [--kanban DONE] [--due 2026-03-15]

Clear a due date: --due null

Projects

exponential projects list

Workspaces

exponential workspaces list

Priority Values

Quick | Scheduled | 1st Priority | 2nd Priority | 3rd Priority | 4th Priority | 5th Priority | Errand | Remember | Watch | Someday Maybe

Kanban Statuses

BACKLOG | TODO | IN_PROGRESS | IN_REVIEW | DONE | CANCELLED

Action Statuses

ACTIVE | COMPLETED | CANCELLED

Output

• TTY (interactive): pretty-printed with colors
• Piped/scripted: JSON output (auto-detected)
• Force JSON: --json
• Force pretty: --pretty

JSON Output Shape

Actions list:

{
  "actions": [{ "id": "...", "name": "...", "status": "ACTIVE", "priority": "1st Priority", "kanbanStatus": "TODO", "project": { "id": "...", "name": "..." }, "dueDate": null }],
  "total": 1,
  "filters": {}
}

Single action (create/update):

{ "id": "...", "name": "...", "status": "ACTIVE", "priority": "Quick", "kanbanStatus": "TODO", "project": { "id": "...", "name": "..." } }

Workflow Patterns

Create tasks for a project:

1. exponential projects list → find the project ID
2. exponential actions create -n "Task" -p <projectId> --priority "1st Priority"

Triage daily work:

1. exponential actions today → see what's due
2. exponential actions update --id <id> --kanban IN_PROGRESS → start working
3. exponential actions update --id <id> --kanban DONE → mark complete

Review project board:

1. exponential actions kanban --project <id> → see full board
2. Filter by status: --status IN_PROGRESS