The direct route

The `ws` command line

The same binary your assistant uses, driven by you. Log accomplishments, browse reviews, manage OKRs, run surveys, and script anything with --output json. If you came here from the AI setup guide, this is the manual path.

Install Command reference

One grammar

Every command is ws <domain> <verb> with the same five verbs and the same universal flags everywhere.

listgetcreateupdatedelete--match--filter--sort--output json

Install

npm (any platform)

The simplest option. Works on macOS, Linux, and Windows wherever you have Node.js installed, and keeps the CLI on your PATH automatically.

Terminal

npm install -g @workspark/cli

macOS and Linux (shell script)

Detects your OS and architecture, downloads the correct binary, and places it in /usr/local/bin.

Terminal

curl -fsSL https://workspark.io/cli/install.sh | sh

Windows (PowerShell)

One line, no Node.js required.

PowerShell

irm https://workspark.io/cli/install.ps1 | iex

Verify

ws --version

Manual downloadFile

macOS (Apple Silicon)ws-darwin-arm64-0.4.0.tar.gz

Linux (x86_64)ws-linux-amd64-0.4.0.tar.gz

Linux (arm64)ws-linux-arm64-0.4.0.tar.gz

Windows (x86_64)ws-windows-amd64-0.4.0.zip

Windows (arm64)ws-windows-arm64-0.4.0.zip

Extract, then sudo mv ws /usr/local/bin/ws , or ~/.local/bin if you'd rather not use sudo, adding it to your PATH.

Authenticate

ws auth loginOpens the browser to sign in.

ws auth whoamiShows your account details and org memberships, including the active org and your roles.

ws auth statusShows current authentication status.

ws auth logoutClears the stored session.

Configure your organization

Most commands run against one active organization. Set it once; override anytime with --organization.

ws config initFirst-time setup wizard. Walks you through selecting your organization.

ws organizations listLists all organisations you belong to.

ws organizations useInteractive picker to set your active organization. Or pass an org ID directly.

Command reference

Accomplishments

ws accomplishments create \
  --content "Shipped the new onboarding flow, cutting time-to-first-value by 40%." \
  --entry-date 2026-05-28

Logs a new accomplishment. AI enrichment fills in the title and category automatically if you omit them. Valid categories: create, execute, lead, learn, maintain, plan, research, share, support. Defaults to your own member record when --member-id is omitted.

ws accomplishments list

Lists your recent accomplishments.

ws accomplishments list \
  --filter entry_date_from=2026-01-01 \
  --filter entry_date_to=2026-03-31

Filter by date range. Useful for preparing a self-review.

ws accomplishments get 01KN17QXK5V42A1W8A4FSDF2KX

Fetch a single accomplishment by ID.

Members

ws members list

Lists members in the active organization.

ws members list --match "Alice"

Search members by name.

OKRs

ws okrs cycles list --match "2026 H1"

Find an OKR cycle by name.

ws okrs list 01KN17QXK5V42A1W8A4FSDF2KX

List OKRs in a cycle (pass the cycle ID).

Tasks

ws tasks boards list

List task boards in the active organization.

Tips & updating

ws <command> --help lists every flag on any subcommand.
--output json makes any list or get scriptable; pipe it into jq.
ws auth whoami before any write confirms the organization.
npm update -g @workspark/cli upgrades. The CLI checks compatibility on every run and warns you when it's out of date.

Want your assistant driving this instead? See WorkSpark for AI assistants →

The ws command line