Developer tools

The ws command line

A single binary that gives AI coding assistants like Claude, Codex, and OpenCode a grounded, scriptable interface to your Workspark data, so they act on real output instead of guesses. The same ws command also brings Workspark to your own terminal: log accomplishments, browse reviews, manage OKRs, run engagement surveys, look up members, and work with tasks, all without leaving your shell.

Up in three commands

Install the binary, sign in with your Google account, then confirm which organisation you are connected to. Most people are running their first command within two minutes.

Terminal
npm install -g @workspark/cli
ws auth login
ws auth whoami

Works on macOS, Linux, and Windows. Prefer a shell script or manual download? See the Install the CLI guide for all options.

A consistent grammar across every domain

Every ws command follows the same shape: ws <domain> <verb>. The verbs are consistent across domains: list, get, create, update, delete. Universal flags like --match, --output json, --sort -field, and --filter field=value work the same way everywhere. Once you know one command, you know them all.

Terminal
# List all accomplishments
ws accomplishments list

# Log a new accomplishment
ws accomplishments create --content "Shipped the new onboarding flow"

# Filter and output as JSON
ws accomplishments list --filter entry_date_from=2026-01-01 --output json

# Search members
ws members list --match "Alice"

# Browse OKR cycles
ws okrs cycles list --match "2026 H1"

Run ws --help or ws <command> --help to see all available flags. The full command reference is in the Install the CLI guide.

Built for AI agents

The same CLI gives Claude, Codex, and OpenCode a grounded interface to your Workspark data. Pair it with the Workspark Skill and your agent can log accomplishments, prep reviews, and update OKRs, all from real output and never fabricated.

Use with AI agentsInstall the CLI