CLI (`ctm`)

The ctm CLI lets you manage tasks and connectors from the terminal. It uses the same API as the MCP server.

Installation

# From the repo root (development)
pnpm --filter @ctm/cli build
# Then link the binary or run directly:
node apps/cli/dist/main.js --help

Authentication

ctm login
# Prompts for email and password
# Stores tokens in ~/.config/ctm/config.json

Access token (non-interactive)

Pass a JWT access token via flag or environment variable to override stored credentials:

ctm tasks --token <access-token> list
# or
CTM_TOKEN=<access-token> ctm tasks list

Custom server URL

ctm tasks --base-url https://your-server.example.com list
# or
CTM_BASE_URL=https://your-server.example.com ctm tasks list

Commands

`ctm login`

Prompts for email and password, stores access and refresh tokens locally.

ctm login [--base-url <url>]

`ctm logout`

Clears stored credentials from ~/.config/ctm/config.json.

`ctm tasks list`

ctm tasks list [--filter all|today|upcoming|done] [--json]

List tasks. Default filter: all.

`ctm tasks create`

ctm tasks create --title "Buy milk" --source local [--description "..."] [--priority 1-4] [--due 2026-06-01]

`ctm tasks update`

ctm tasks update <id> [--title "New title"] [--description "..."] [--priority 2] [--due 2026-06-01] [--tags "work,urgent"]

`ctm tasks complete`

ctm tasks complete <id> [--json]

`ctm tasks delete`

ctm tasks delete <id>

`ctm tasks set-fuzzy-deadline`

ctm tasks set-fuzzy-deadline <id> --type this_week|this_month|someday [--remind daily|weekly]

`ctm connectors list`

ctm connectors list [--json]

`ctm connectors connect`

ctm connectors connect todoist
# Opens OAuth URL in your default browser

`ctm connectors disconnect`

ctm connectors disconnect todoist

Flags

--token and --base-url are available on the tasks and connectors command groups:

Flag	Env var	Description	Example
`--token <t>`	`CTM_TOKEN`	Override stored credentials	`ctm tasks --token <t> list`
`--base-url <url>`	`CTM_BASE_URL`	Override API base URL	`ctm tasks --base-url http://... list`

Installation​

Authentication​

Interactive login (stores credentials)​

Access token (non-interactive)​

Custom server URL​

Commands​

ctm login​

ctm logout​

ctm tasks list​

ctm tasks create​

ctm tasks update​

ctm tasks complete​

ctm tasks delete​

ctm tasks set-fuzzy-deadline​

ctm connectors list​

ctm connectors connect​

ctm connectors disconnect​

Flags​