Develop

AI tooling

Updated: Jun 10, 2026

Fastest way to get started

The portal skill⁠ is a self-contained reference that teaches your AI coding tool everything it needs to build for Portal. You don’t need to read any other documentation — just point your AI tool at the skill and start building. It covers:
  • Portal hardware constraints (no GMS, SDK versions, manifest requirements, icon rules)
  • Device setup and ADB enablement
  • Design guidelines for tabletop form factors
  • Porting existing Android apps to Portal

Meta VR CLI (metavr)

You can also use Meta VR CLI, a command-line tool that wraps ADB with higher-level commands for managing devices, installing apps, capturing screenshots, reading logs, and transferring files. It includes an MCP (Model Context Protocol) server — it gives your AI coding tool programmatic access to your Portal and automatically loads the portal skill.

Install Meta VR CLI

Requires Node.js 20 or newer.
npx -y metavr --version
This pulls the latest version on every run. To install globally instead:
npm install -g metavr

Connect to your AI coding tool

Install the MCP server for your tool of choice:
metavr mcp install claude-code
metavr mcp install cursor
metavr mcp install vscode
metavr mcp install android-studio
metavr mcp install codex
metavr mcp install zed
metavr mcp install windsurf
metavr mcp install gemini-cli
For a full list, run metavr mcp install --help.
With ADB enabled on your Portal and the USB-C cable connected:
metavr device list
Your Portal should appear. If it does not, see the Set up your device page.

Common Meta VR CLI commands

metavr app install app/build/outputs/apk/debug/app-debug.apk
metavr app launch com.example.myapp
metavr app stop com.example.myapp
metavr app list
metavr capture screenshot
metavr log --tag MyApp --level W
metavr shell getprop ro.product.model

Troubleshooting

Loading the skill manually

To load the skill manually in your AI tool:
/read-skill portal
In tools with MCP, the skill loads automatically when you mention Portal or target minSdkVersion 28-29.

Targeting a specific device

If you have more than one device connected, pin the target device (you can find your serial number with metavr device list):
metavr -d YOUR_DEVICE_SERIAL app install app-debug.apk
Or set it once for the session:
export METAVR_DEVICE=YOUR_DEVICE_SERIAL
Nav Logo
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
English (US)
© 2026 Meta