Skip to Content

Workspace Management

TL;DR

CMDOP workspaces organize machines and team access. List workspaces with cmdop workspace list, switch with cmdop workspace use <name>, and create new ones with cmdop workspace create. Manage members with invite/remove commands and assign roles (owner, admin, member, guest). Supports API key management with scoped permissions, workspace-level settings, and audit logging.

Manage workspaces and team access.

How do I list my workspaces?

# Show all workspaces you belong to with roles and machine counts
cmdop workspace list

Output:

NAME              ROLE      MACHINES
acme-corp         owner     12
staging           admin     5
personal          owner     2

How do I switch workspaces?

# Set the active workspace for subsequent commands
cmdop workspace use <name>

Example:

# Switch to the staging workspace
cmdop workspace use staging

Output:

✓ Switched to workspace: staging

How do I check the current workspace?

# Display active workspace, role, and member/machine count
cmdop workspace current

Output:

Workspace: acme-corp
Role:      owner
Machines:  12
Members:   5

How do I create a workspace?

# Create a new workspace for your team or project
cmdop workspace create <name>

Example:

# Create a workspace with a display name
cmdop workspace create "my-project"

Options:

cmdop workspace create "my-project" --slug my-project

How do I manage workspace members?

How do I list members?

# Show all members with email, role, and join date
cmdop workspace members

Output:

EMAIL                   ROLE      JOINED
[email protected]       owner     2026-01-01
[email protected]         admin     2026-01-15
[email protected]     member    2026-02-01

How do I invite a member?

# Send workspace invitation with a specific role
cmdop workspace invite <email> --role <role>

Example:

# Invite a teammate with member-level access
cmdop workspace invite [email protected] --role member

Roles:

  • owner — Full control
  • admin — Manage machines and members
  • member — Access sessions
  • guest — Read-only (optional)

How do I remove a member?

# Remove a member from the workspace
cmdop workspace remove <email>

How do I change a member’s role?

# Update a member's access level
cmdop workspace set-role <email> <role>

Example:

# Promote a member to admin
cmdop workspace set-role [email protected] admin

How do I manage API keys?

How do I list keys?

# List all API keys with permissions and last-used time
cmdop auth list-keys

Output:

NAME          CREATED       LAST USED       PERMISSIONS
my-laptop     2026-01-15    just now        sessions:*,files:*
ci-cd         2026-02-01    1 hour ago      commands:execute

How do I create a key?

# Generate a new API key with a descriptive name
cmdop auth create-key --name "my-script"

Output:

API Key created: cmd_acme_a1b2c3d4e5f6...

⚠ Copy this key now. It won't be shown again.

Options:

# With specific permissions
cmdop auth create-key --name "read-only" --permissions sessions:read,files:read
 
# With expiration
cmdop auth create-key --name "temp" --expires 30d

How do I revoke a key?

# Permanently invalidate an API key
cmdop auth revoke-key cmd_acme_xxx

How do I manage workspace settings?

How do I view settings?

# Display all workspace configuration options
cmdop workspace settings

How do I update settings?

# Modify a workspace setting by key
cmdop workspace settings set <key> <value>

Example:

# Set the default shell for new terminal sessions
cmdop workspace settings set default-shell /bin/zsh

How do I delete a workspace?

# Delete a workspace (requires confirmation)
cmdop workspace delete <name>

Requires confirmation:

# Skip interactive prompt with --confirm flag
cmdop workspace delete old-project --confirm

This deletes:

  • All machines
  • All sessions
  • All API keys
  • All audit logs

How do I override the workspace for a single command?

Use --workspace flag for single command:

cmdop machines --workspace staging
cmdop terminal server --workspace production

How do I view audit logs?

View workspace activity:

# View all workspace activity events
cmdop audit list

Options:

# Last 7 days
cmdop audit list --days 7
 
# Filter by user
cmdop audit list --user [email protected]
 
# Filter by action
cmdop audit list --action session.created
Last updated on
Overview