> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GBOX CLI

## Installation

### System Requirements

* macOS 10.15 or later
* [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/)
* [Homebrew](https://brew.sh)

> Note: Please check [https://github.com/babelcloud/gbox](https://github.com/babelcloud/gbox) for support of other platforms.

### Installation Steps

```bash theme={null}
# Install GBOX CLI
brew install gbox

# Login to GBOX.cloud (GitHub authorization required)
gbox login
```

### Update Steps

```bash theme={null}
# Update GBOX to the latest version
brew update && brew upgrade gbox
```

### Command Line Usage

The project provides a command-line tool `gbox` for managing sandbox containers:

```bash theme={null}
# Available Commands:
  gbox login          Login using GitHub OAuth
  gbox box            Manage box resources
  gbox device-connect Manage remote connections for local Android development devices
  gbox port-forward   Forward one or more ports from a remote box to your local machine (multi-port, kubectl style)
  gbox mcp            Manage MCP configuration operations
  gbox profile        Manage configuration profiles
  gbox version        Print the client version information
  gbox completion     Generate the autocompletion script for the specified shell                         # preview merge result
```