Develop

AI tooling

Updated: Aug 27, 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 do not need to read any other documentation. 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. It wraps ADB in higher-level commands, covering:
  • Managing devices
  • Installing apps
  • Capturing screenshots
  • Reading logs
  • Transferring files
It also runs an MCP (Model Context Protocol) server. That gives your AI coding tool direct access to your Portal, and loads the portal skill for you.

Install Meta VR CLI

See Install Meta VR CLI for the native installer and the npm package. Confirm it is working:
metavr --version

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
English (US)
© 2026 Meta