# @meta-quest/hzdb

Horizon Debug Bridge (hzdb) - CLI and MCP server for Meta Quest development, device management, performance tracing, and AI-assisted workflows

## Installation

```bash
npm install -g @meta-quest/hzdb
```

Or use directly with npx:

```bash
npx @meta-quest/hzdb --help
```

## Commands

| Command | Description |
|---------|-------------|
| `hzdb device` | Manage connected Meta Quest devices (list, info, connect, battery) |
| `hzdb app` | Manage applications (install, uninstall, launch, stop, info) |
| `hzdb capture` | Capture screenshots and screen recordings from the device |
| `hzdb files` | Manage files on the device (ls, push, pull, rm, mkdir) |
| `hzdb log` | View device logs (logcat) |
| `hzdb shell` | Run shell commands on the device |
| `hzdb perf` | Performance analysis and Perfetto trace tools |
| `hzdb docs` | Search and fetch Meta Quest developer documentation |
| `hzdb asset` | Search Meta's 3D asset library for models |
| `hzdb adb` | Low-level ADB-compatible commands |
| `hzdb mcp` | Built-in MCP server for AI assistant integration |

## MCP Server

hzdb includes a built-in [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server with 40+ tools for device management, app control, file operations, documentation search, performance tracing, and more. This lets AI coding assistants interact directly with your Meta Quest device.

### Install the MCP server into your AI tool

```bash
# Claude Code
hzdb mcp install claude-code

# Claude Desktop
hzdb mcp install claude-desktop

# Cursor
hzdb mcp install cursor

# VS Code / VS Code Insiders
hzdb mcp install vscode
hzdb mcp install vscode-insiders

# Windsurf
hzdb mcp install windsurf

# Zed
hzdb mcp install zed

# Android Studio (Gemini)
hzdb mcp install android-studio

# Gemini CLI
hzdb mcp install gemini-cli

# OpenAI Codex CLI
hzdb mcp install codex

# LM Studio
hzdb mcp install lm-studio

# OpenCode
hzdb mcp install open-code

# Google Antigravity (Gemini)
hzdb mcp install antigravity

# Generic project-local config
hzdb mcp install project
```

## Supported Platforms

- `darwin-arm64` (`@meta-quest/hzdb-darwin-arm64`)
- `darwin-x64` (`@meta-quest/hzdb-darwin-x64`)
- `win32-x64` (`@meta-quest/hzdb-win32-x64`)

Only the binary for your current platform will be downloaded.