gb org

Manage organizations for team collaboration.

Synopsis


gb org [command] [options]

Description

Manage organizations to share genboxes and resources with your team. Organizations provide a shared context for creating and managing environments, with role-based access control.

Subcommands

Command	Description
`gb org`	Show current context and list organizations
`gb org list`	List organizations you’re a member of
`gb org create <username>`	Create a new organization
`gb org info [username]`	Show organization details
`gb org switch <username>`	Switch to organization context
`gb org invite <org> <email>`	Invite a member
`gb org members [username]`	List organization members
`gb org leave <username>`	Leave an organization
`gb org delete <username>`	Delete an organization (owner only)

Examples

Show Current Context


gb org


Current Context
  Working in: personal (your account)

Your Organizations
  acme-corp - Acme Corporation [owner]
    5 members
  startup-inc - Startup Inc [member]
    3 members

  Switch context: gb org switch <username>

List Organizations


gb org list


Organizations

  acme-corp
    Display name: Acme Corporation
    Role: owner
    Members: 5

  startup-inc
    Display name: Startup Inc
    Role: member
    Members: 3

Create Organization


gb org create acme


? Display name: Acme Corporation

✓ Organization 'acme' created!
  Display name: Acme Corporation

  Switch to it: gb org switch acme
  Invite members: gb org invite acme alice@example.com

With options:


gb org create acme --name "Acme Corporation" --description "Our dev team"

Show Organization Details


gb org info acme-corp


Organization: acme-corp
  Display name: Acme Corporation
  Description: Our development team
  Your role: owner
  Tier: pro
  Credits: 5000 + 1000 addon

  Members:
    alice@example.com [owner]
    bob@example.com [admin]
    charlie@example.com [member]

  Pending Invitations:
    dave@example.com [member] - pending

Switch Context


# Switch to organization
gb org switch acme-corp


✓ Switched to organization: Acme Corporation
  New genboxes will be created under acme-corp.
  URLs: https://{genbox}.app.acme-corp.genbox.dev


# Switch back to personal account
gb org switch personal


✓ Switched to personal context
  New genboxes will be created under your personal account.

Invite Member


gb org invite acme-corp alice@example.com


✓ Invitation sent to alice@example.com
  Role: member
  Expires: 2025-01-09T10:30:00Z

With role:


gb org invite acme-corp bob@example.com --role admin

List Members


gb org members acme-corp


Members of acme-corp
  alice@example.com [owner]
  bob@example.com [admin]
  charlie@example.com [member]

Pending Invitations
  dave@example.com [member] - pending

Leave Organization


gb org leave acme-corp


? Are you sure you want to leave organization 'acme-corp'? Yes
✓ You have left organization 'acme-corp'
  Switched to personal context.

Delete Organization


gb org delete acme-corp


? Type the organization username "acme-corp" to confirm deletion: acme-corp
✓ Organization 'acme-corp' has been deleted

Roles

Role	Permissions
`owner`	Full access, can delete org, manage all members
`admin`	Manage members, create/delete genboxes
`member`	Create genboxes, access shared resources

Organization Context

When you switch to an organization context:

New genboxes are created under the organization
URLs use organization namespace: https://{genbox}.app.{org}.genbox.dev
Organization credits are used
Team members can access shared genboxes

Notes

Organization usernames must be unique and URL-safe
Owners cannot leave without transferring ownership
Deleting an organization removes all its genboxes
Credits are separate from personal account