game workspace

Manage workspaces for organizing packages in Game Framework Cloud. Workspaces provide isolated environments for different teams, projects, or environments.

Subcommands

• list - List available workspaces
• select - Select a workspace
• current - Show current workspace

workspace list

List all workspaces you have access to.

Usage

game workspace list

Example Output

📦 Available Workspaces:

1. my-company-prod (ws-abc123)
   Plan: Pro
   Members: 15
   Packages: 23

2. my-company-staging (ws-def456)
   Plan: Free
   Members: 8
   Packages: 12

3. personal-projects (ws-ghi789)
   Plan: Free
   Members: 1
   Packages: 3

workspace select

Select a workspace to use for publishing and package operations.

Usage

# Interactive selection (recommended)
game workspace select

# Direct selection by ID
game workspace select ws-abc123

# Force interactive mode
game workspace select --interactive

Interactive Mode

When run without a workspace ID, you'll see an arrow-key selection menu:

? Select a workspace:
❯ my-company-prod (ws-abc123) - Pro Plan
  my-company-staging (ws-def456) - Free Plan  
  personal-projects (ws-ghi789) - Free Plan

Use arrow keys to navigate and Enter to select.

workspace current

Show details about the currently selected workspace.

Usage

game workspace current

Example Output

Current Workspace:
  Name: my-company-prod
  ID: ws-abc123
  Plan: Pro
  Members: 15
  Packages: 23/50
  Storage: 45.2 GB / 100 GB
  Bandwidth: 125 GB / 500 GB (this month)

Workspace Concepts

What is a Workspace?

A workspace is an isolated environment for your packages:

• Separate package namespaces
• Independent member access
• Isolated billing and quotas
• Team collaboration space

Multiple Workspaces

You can belong to multiple workspaces:

• Production - Live packages for production apps
• Staging - Testing and development packages
• Personal - Individual experiments
• Client Projects - Agency client workspaces

Switch between them with game workspace select.

Workspace Plans

Free Plan

• 5 packages
• 5 GB storage
• 50 GB bandwidth/month
• 5 workspace members

Pro Plan ($49/month)

• 50 packages
• 100 GB storage
• 500 GB bandwidth/month
• 25 workspace members

Enterprise Plan (Custom)

• Unlimited packages
• Unlimited storage
• Unlimited bandwidth
• Unlimited members
• SLA guarantees
• Premium support

Configuration

The selected workspace is stored in ~/.game/config.yml:

defaults:
  workspace_id: "ws-abc123"
  api_url: "http://localhost:4000"

You can also override the workspace for individual commands:

game publish --workspace ws-def456

Workspace Management

Creating Workspaces

Workspaces are created through the Game Framework web interface or API. Contact your administrator or visit the dashboard to create new workspaces.

Member Management

Workspace owners can:

• Invite members
• Assign roles (Owner, Developer, Tester, Viewer)
• Remove members
• Manage permissions

Viewing Members

Currently, member management is done through the web interface. Future CLI versions may include:

game workspace members list
game workspace members add user@example.com

Troubleshooting

No Workspaces Available

Error: No workspaces found

Solutions:

• Ensure you're logged in: game login
• Check you have access to at least one workspace
• Create a workspace in the web interface

Workspace Not Found

Error: Workspace ws-abc123 not found

Solutions:

• Verify the workspace ID is correct
• Check you have access to this workspace
• List available workspaces: game workspace list

Permission Denied

Error: Permission denied for workspace operation

Solutions:

• Check your role in the workspace
• Contact workspace owner for access
• Verify you're using the correct workspace

Related Commands

• game login - Authenticate to access workspaces
• game publish - Publish to selected workspace
• game config - View configuration

Next Steps

After selecting a workspace:

1. Publish packages with game publish
2. View configuration with game config show
3. Manage in web interface - Full workspace management