Workspaces

A workspace is the team you act in — watched accounts and stagenets belong to a workspace. The CLI always acts on one active workspace.

Your API key is account-level; the active workspace is a local setting sent with each request (membership is checked server-side).

workspace

Show the active workspace:

contract.dev workspace

Acme (acme)

workspace list

List the workspaces you belong to (* marks the active one):

contract.dev workspace list

* Acme  (acme)
  Personal  (theo)

workspace use

Switch the active workspace. The reference can be a slug, id, or name:

contract.dev workspace use acme

CI

Credentials from CONTRACT_DEV_API_KEY have no local settings — pick the workspace per run with CONTRACT_DEV_WORKSPACE (id or slug) instead of workspace use.