Reference

Global flags

All commands accept:

Flag	Description
`--json`	Emit raw JSON instead of the human-readable table.
`--help`	Show usage for the current command.

List commands additionally accept:

Flag	Description
`--page <n>`	Page index (1-based).
`--page-size <n>`	Items per page. Default 20.

Variable	Used for
`WK_VERSION`	Pin a version when running the install script.
`WK_INSTALL_DIR`	Override the install script’s target directory.
`WK_TOKEN`	Pre-minted CLI token (skip the browser login).
`WK_BASE_URL`	Override the platform base URL (defaults to `https://platform.wavekat.com`).

Each command maps to a single platform endpoint:

Command	Endpoint
`wk login`	Loopback OAuth + `GET /api/me`
`wk logout`	`POST /api/auth/cli/tokens/revoke-current`
`wk me`	`GET /api/me`
`wk version`	Local binary + `GET /api/health`
`wk update`	`GET /repos/wavekat/wavekat-cli/releases/latest` (GitHub) + re-runs `install.sh`
`wk agents`	Local-only; prints the bundled `AGENTS.md`
`wk projects list`	`GET /api/projects`
`wk projects show <id>`	`GET /api/projects/{id}`
`wk annotations list <project-id>`	`GET /api/projects/{id}/annotations`
`wk files list <project-id>`	`GET /api/projects/{id}/files`
`wk files reserve <id> [<id>…]`	`POST /api/files/{id}/test-reservation` (one call per id)
`wk files unreserve <id> [<id>…]`	`DELETE /api/files/{id}/test-reservation` (one call per id)
`wk files summary <project-id>`	`GET /api/projects/{id}/files/summary`
`wk exports list <project-id>`	`GET /api/projects/{id}/exports`
`wk exports show <export-id>`	`GET /api/exports/{id}`
`wk exports create <project-id>`	`POST /api/projects/{id}/exports`
`wk exports download <export-id>`	`GET /api/exports/{id}/manifest` + per-clip `GET /api/exports/{id}/clips/{annotation-id}`
`wk exports delete <export-id>`	`DELETE /api/exports/{id}`
`wk exports adapt smart-turn`	Local-only; reads a downloaded snapshot
`wk models list <project-id>`	`GET /api/projects/{id}/models`
`wk models show <model-id>`	`GET /api/models/{id}`
`wk models push …`	`POST /api/projects/{id}/models` + artifact upload
`wk models download <model-id>`	`GET /api/models/{id}/artifacts/{name}`

This table is a snapshot; the binary itself is authoritative. Every subcommand has self-describing help via clap:

wk --help                   # top-level groups
wk exports --help           # one group
wk exports create --help    # all flags, types, defaults

When in doubt, run --help rather than guessing.

Stored at:

Platform	Path
macOS	`~/Library/Application Support/wavekat/auth.json`
Linux	`~/.config/wavekat/auth.json`
Windows	`%APPDATA%\wavekat\auth.json`

Mode is 0600 on Unix. The file contains the active CLI token; wk logout revokes it server-side and then removes the file.