game workspace

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

Subcommands

list (alias ls) - List available workspaces
select (alias use) - Select a workspace
current - Show current workspace

The workspace command itself has the alias ws (e.g. game ws ls).

workspace list

List all workspaces you have access to.

Usage

game workspace list   # alias: game ws ls

Example Output

A table of your workspaces; * marks the current one:

   NAME                SLUG                 PLAN   PACKAGES
 * my-company-prod     my-company-prod      PRO    23
   my-company-staging  my-company-staging   FREE   12
   personal-projects   personal-projects    FREE   3

workspace select

Select a workspace to use for publishing and package operations.

Usage

# Interactive selection (also used when no argument is given)
game workspace select

# Select by slug (resolved by slug first, then id); alias: game ws use <slug>
game workspace select my-company-prod

# Force interactive mode
game workspace select --interactive   # or -i

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.

The selected workspace is saved in ~/.game/config.yml and used for all subsequent operations.

workspace current

Show details about the currently selected workspace.

Usage

game workspace current

Example Output

Current workspace:

  Name: my-company-prod
  Slug: my-company-prod
  ID: ws-abc123
  Plan: pro

  Limits:
    Max Packages: 50
    Max Storage: 100 GB
    Max Downloads: 100000

  Usage:
    Packages: 23 / 50
    Storage: 45.2 GB / 100 GB
    Downloads: 1240 / 100000

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"

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

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

Next Steps

After selecting a workspace:

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

Workspaces help organize packages by team, project, or environment - perfect for enterprise teams!

On this page