gbox for Mac

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

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: Cloud Virtual Device:

Login to GBOX.AI to get a cloud virtual device. Best for testing and development. 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. 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.

Linux Desktop/Browser Environment

Login to GBOX.AI to get a Linux desktop/browser environment. Best for testing and development.

Develop gbox