babelcloud/gbox

**GBOX** provides environments for AI Agents to operate computer and mobile devices.
*Mobile Scenario:*
Your agents can use GBOX to develop/test android apps, or run apps on the Android to complete various tasks(mobile automation).
*Desktop Scenario:*
Your agents can use GBOX to operate desktop apps such as browser, terminal, VSCode, etc(desktop automation).
*MCP:*
You can also plug GBOX MCP to any Agent you like, such as Cursor, Claude Code. These agents will instantly get the ability to operate computer and mobile devices.
Installation
System Requirements
- MacOS
- Version: 10.15 or later
- Homebrew
> Note: Using gbox on other platforms, please check npm package @gbox.ai/cli for installation instructions. You can also login to GBOX.AI to use web-based dashboard.
Installation Steps
Quick Install (Recommended)
**Option 1: Install GBOX CLI only**
This installs just the GBOX CLI. Additional dependencies (like ADB, frpc, Appium) will be automatically installed when needed, or you can install them later using:
**Option 2: Install with all dependencies (one-step setup)**
This installs everything at once:
- GBOX CLI
- Node.js and npm (if not present)
- Android Debug Bridge (ADB)
- FRP client (frpc)
- Appium server, drivers and plugins
**Non-Interactive Mode:**
Alternative Installation Methods
**Via Homebrew (macOS):**
**Via npm (Linux/Windows):**
Setup Dependencies
If you installed GBOX CLI only, you can install all command dependencies anytime:
Or install them interactively:
Update GBOX CLI
Keep your GBOX CLI up to date:
**Using the install script:**
**Using Homebrew (macOS):**
**Using npm (Linux/Windows):**
Get Started
Command Line Usage
Check GBOX CLI Reference for detailed usage.
SDK Usage
Check GBOX SDK Reference for detailed usage.
Use GBOX as a MCP Server(Login required)
Using GBOX CLI to configure MCP server to your Claude Code/Cursor:
Or copy paste the following content into your Claude Code/Cursor MCP config:
> Note:
> - Currently, GBOX MCP can only control Android environments.
> - If you need Cursor/Claude Code to control your local Android device, please check Register Local Device
Android MCP Use Cases
| Use Case | Demo |
|----------|------|
| Claude Code Develop/Test Android App | |
| Claude Code Compare Prices on eCommerce Apps | |
Environments
Currently, GBOX supports the following environments:
- Android
- Linux Desktop/Browser
Android Environment
There are three types of Android environments, you can choose based on your needs:
**1. Cloud Virtual Device:**
Login to GBOX.AI to get a cloud virtual device. Best for testing and development.
**2. Cloud Physical Device:**
Login to GBOX.AI to get a cloud physical device. Cloud physical device is a real Android phone that you can use for production scenarios.
**3. Local Physical Device:**
Use your own physical device Register Local Device. Your local device can be any Android device that have Developer Mode enabled. Best for production scenarios and personal use.