Workspaces

A workspace is the top-level organisational unit. It contains projects, tracks billing, and holds the team members who can access resources within it.

The workspace command can be shortened to ws:

edge ws list

list

List all workspaces your account has access to. The active workspace is marked with *.

edge workspace list
edge workspace list --json

Example output

    SLUG          NAME           PLAN
*   acme-corp     Acme Corp      pro
    side-proj     Side Project   free

create

Create a new workspace.

edge workspace create <name>

edge workspace create "Acme Corp"

The slug is derived automatically from the name.

use

Set the active workspace. All subsequent commands that require a workspace will use this value unless overridden with --workspace/-w or a .edge.json link file.

edge workspace use <slug|name>

You can pass either the slug or the human-readable name. Names with spaces must be quoted:

edge workspace use acme-corp
edge workspace use "Acme Corp"

After the workspace is set, the CLI also resolves the active project and environment:

• Interactive terminal — you are prompted to pick a project from a numbered list, then an environment within that project.
• Non-interactive / CI — pass --project and --env to set all three in one command:

edge workspace use acme-corp --project payments --env production

If --project is omitted in a non-interactive environment, the active project and environment are cleared and a warning is shown.

On success the CLI prints the name and slug for each value set:

✓ Active workspace set to Acme Corp (acme-corp)
✓ Active project set to Payments Service (payments)
✓ Active environment set to Production (production)

All settings are saved to ~/.simplifyd/config.json.

usage

Show resource usage for the active (or specified) workspace.

edge workspace usage
edge workspace usage --workspace acme-corp --json

Example output

RESOURCE      COUNT
Services      12
Deployments   48
Members       5

members

Manage the members of a workspace.

members list

edge workspace members list
edge workspace members list --workspace acme-corp --json

members add

Add one or more members by email address. The invited user must already have a Simplifyd Cloud account. All addresses are submitted in a single request — if any address is invalid or already a member, the entire call fails.

# Add a single member
edge workspace members add bob@example.com

# Add multiple members at once
edge workspace members add bob@example.com carol@example.com dave@example.com

members remove

Remove a member by their member ID (visible in members list).

edge workspace members remove <member-id>