Workspaces

A workspace is the team you act in — your contracts, metrics, monitors and stagenets belong to a workspace. The CLI’s credentials are bound to one workspace: the one that was active in the app when you approved the login.

workspace

Show the workspace the credentials are bound to:

contract.dev workspace

Acme (acme)

workspace list

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

contract.dev workspace list

* Acme  (acme)
  Personal  (theo)

workspace use

Switch to another workspace. Because credentials are bound to one workspace, this runs the login again: make the target the active workspace in the app, then approve. The reference can be a slug, id, or name.

contract.dev workspace use personal

Credentials are bound to Acme. To act on Personal, make it the active workspace in the app, then approve the login.

  One-time code: ABCD-1234

Opening https://app.contract.dev/activate?code=ABCD-1234
Waiting for approval...
Logged in as you@example.com
Active workspace: Personal (theo)

If the login was approved with a different workspace active, the CLI says which one it is bound to and asks you to switch and run the command again.