> ## 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.

# VSCode

> Integrate GBOX with VSCode for seamless Android app testing and development workflow.

## Getting Started

<Steps>
  <Step title="Install GBOX CLI">
    Install the GBOX CLI tool to manage your GBOX configuration.

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

    # Update GBOX if already installed
    brew update && brew upgrade gbox
    ```
  </Step>

  <Step title="Login and Configure GBOX">
    Authenticate with your GBOX account and set up the configuration.

    ```bash theme={null}
    gbox login
    ```

    This command will prompt you to enter your GBOX API key and configure your account.
  </Step>

  <Step title="Configure MCP Server with VSCode">
    Set up the Model Context Protocol (MCP) server to enable communication between VSCode and GBOX.

    You can configure the MCP server either globally or at the project level:

    **Global Configuration:**
    Create or modify your MCP configuration file at `~/.vscode/mcp.json`:

    **Project-Level Configuration:**
    Alternatively, you can create the configuration file at `.vscode/mcp.json` in your project directory for project-specific settings.

    ```json theme={null}
    {
      "servers": {
        "gbox-android": {
          "command": "npx",
          "args": [
            "-y",
            "@gbox.ai/mcp-server@latest"
          ]
        }
      }
    }
    ```

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/vscode/vscode-02.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=a866063efe26e2b17c3c0f2599b9b462" alt="MCP Server Configuration" width="1280" height="848" data-path="images/integrations/ide/vscode/vscode-02.png" />
  </Step>

  <Step title="Add VSCode Copilot Instructions">
    Create a project-level instruction file to guide Copilot Agents during testing. You can start by copying our template and then customizing it:

    ```bash theme={null}
    cd <your-android-repo-dir>
    mkdir -p .github
    curl -fsSL https://raw.githubusercontent.com/babelcloud/open-webui/refs/heads/main/.github/instructions/android-testing.instructions.md -o .github/android-testing.instructions.md   
    ```

    You can include:

    * Test account credentials
    * Project-specific setup guides
    * Feature specs and limitations
  </Step>

  <Step title="Develop and Test Your Android App with VSCode Copilot">
    In VSCode with GitHub Copilot **Agent Mode** enabled, you can now use AI agents to test your Android applications.

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/vscode/vscode-03.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=bb30062d5f6a844df6121d4ab9f10bc7" alt="VSCode Copilot Setup 1" width="1280" height="852" data-path="images/integrations/ide/vscode/vscode-03.png" />

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/vscode/vscode-04.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=6f50f9ec60ec3856c47714bf73d9d306" alt="VSCode Copilot Setup 2" width="1280" height="852" data-path="images/integrations/ide/vscode/vscode-04.png" />

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/vscode/vscode-05.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=04c0cef1f96d9e78532621b205834753" alt="VSCode Copilot Setup 3" width="1280" height="852" data-path="images/integrations/ide/vscode/vscode-05.png" />
  </Step>

  <Step title="Connect a local Android device">
    By default, GBOX MCP uses a cloud android VM. To connect GBOX to your own Android devices, see [Register Local Devices](https://docs.gbox.ai/cli/register-local-device).
  </Step>
</Steps>