wspc

Official TypeScript SDK and CLI for wspc.ai.

Status: v0 walking skeleton. Covers the todo domain only.

Install

npm i -g @wspc/cli

This installs the wspc binary globally.

Quick start

wspc login                                  # OAuth device flow
wspc todo project ls                        # find a project id
wspc todo add "Buy milk" --project prj_xxx  # create
wspc todo ls --project prj_xxx              # list
wspc todo show tod_xxx                      # detail view
wspc todo done tod_xxx                      # mark done

--project (-p) is required on every list / create because the wspc API scopes todos per project. Run wspc todo project ls to discover ids.

Commands

| Command | Notes | | --- | --- | | wspc login / logout / whoami | OAuth device-flow auth; tokens stored in your local configuration file (with strict file permissions). | | wspc todo {add, ls, show, update, rm, done} | Core todo CRUD. done is a sugar over update --status done. | | wspc todo project {add, ls} | Project scope. | | wspc todo type ls | List todo types. | | wspc todo rule ls | List recurrence rules. | | wspc config | Inspect / clear local config. |

Pass --help to any subcommand for flags, aliases, and examples.

Output: pretty by default, JSON for scripts

Commands print a coloured aligned table (lists) or key-value block (detail views) when stdout is a terminal, and raw JSON when output is piped to a file or another command:

wspc todo ls -p prj_xxx                 # pretty: table with status icons, relative due dates
wspc todo ls -p prj_xxx | jq '.todos'   # JSON: pipe-detected, no opt-in needed
wspc todo ls -p prj_xxx --json          # JSON: forced even in a terminal

Ids are rendered with the discriminating prefix bright and the rest dimmed — they look short but terminal text selection copies the full 30-character id so you can paste it straight into the next command. No truncation, no 404s.

The mode can also be forced via env:

| WSPC_OUTPUT value | Effect | | --- | --- | | pretty | Always render the table / key-value layout, even when piped. Useful in CI logs and screenshots. | | json | Always emit JSON, even in a terminal. Same as --json. | | (unset) | TTY-detected. --json still wins. |

Colour follows the NO_COLOR and FORCE_COLOR conventions on top of TTY detection.

One-off invocations

If you'd rather not install globally, use npx — but two flags matter:

• -p @wspc/cli@latest: the package is @wspc/cli but the binary is wspc, so npx's default short form (npx @wspc/cli ...) can't resolve the bin on Windows. The @latest (or any explicit version) is also required — without it npx may dispatch flags like --version to itself.
• -y: skip the "install this?" prompt (optional but recommended for scripts).

npx -y -p @wspc/cli@latest wspc --version
npx -y -p @wspc/cli@latest wspc todo ls --project prj_xxx

See full docs at https://wspc.ai/docs (coming soon).

License

MIT