@meta-quest/hzdb

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

Installation

npm install -g @meta-quest/hzdb

Or use directly with npx:

npx @meta-quest/hzdb --help

Commands

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

MCP Server

hzdb includes a built-in Model Context Protocol (MCP) server with 35+ 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

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