Gbox CLI

# Install via Homebrew
brew tap babelcloud/gru && brew install gbox

# Initialize environment
gbox setup

# Export MCP config and merge into Claude Desktop
gbox mcp export --merge-to claude
# or gbox mcp export --merge-to cursor

# Restart Claude Desktop

# Update gbox to the latest version
brew update && brew upgrade gbox

# Update the environment
gbox setup

# Export and merge latest MCP config into Claude Desktop
gbox mcp export --merge-to claude
# or gbox mcp export --merge-to cursor

# Restart Claude Desktop

# Login to gbox.cloud
gbox login

# Profile management
gbox profile add --key <key> --name <name>                  # add profile
gbox profile list                                           # list all profiles
gbox profile use [index]                                    # switch current profile (interactive if index omitted)
gbox profile delete <index>                                 # delete profile
gbox profile current                                        # show current profile

# Local environment
gbox setup                                                  # initialize local runtime environment (alias: cluster setup)
gbox cleanup                                                # clean up local runtime environment (alias: cluster cleanup)

# Container (Box) management
gbox box create --image python:3.9 --env DEBUG=true -- python -c "print('hello')"  # create a box
gbox box list                                               # list boxes
gbox box terminate <box-id>                                 # terminate box
gbox box exec <box-id> -- ls /                              # execute command inside box
gbox box cp <box-id>:<container-path> <local-path>          # file copy
gbox box inspect <box-id>                                   # inspect box

# Android CUA (requires OPENAI_API_KEY)
gbox cua android "Open Uber and order a ride to CUHK"

# MCP configuration
gbox mcp export                                             # export config only
gbox mcp export --merge-to claude                           # integrate linux mcp server into Claude Desktop
gbox mcp export --merge-to cursor                           # integrate linux mcp server into Cursor
gbox mcp export --merge-to claude-code --type android       # integrate android mcp server into Claude Code
gbox mcp export --dry-run                                   # preview merge result