@myerscarpenter/quest-dev
v1.0.6
Published
CLI for Meta Quest Browser development - screenshot and URL opening via ADB and cdp-cli
Maintainers
Readme
quest-dev
CLI tools for Meta Quest Browser development. Take screenshots and open URLs on your Quest device via ADB.
Installation
npm install -g @myerscarpenter/quest-devPrerequisites
ADB - Android Debug Bridge must be installed and in your PATH
- macOS:
brew install android-platform-tools - Linux:
sudo apt install adb - Windows: Download Platform Tools
- macOS:
Quest Device - Connected via USB with Developer Mode and USB Debugging enabled
cdp-cli (optional) - For smart tab reuse in the
opencommandnpm install -g @myerscarpenter/cdp-cli
Usage
Screenshot
Take a screenshot from Quest and save it locally:
quest-dev screenshot ./screenshot.jpg
quest-dev screenshot ~/Pictures/quest-capture.jpgThis uses Quest's native screenshot service which captures the full VR view, including immersive content that CDP screenshots can't capture.
Open URL
Open a URL in Quest Browser with automatic ADB port forwarding:
quest-dev open http://localhost:3000/
quest-dev open http://localhost:9004/my-xr-app/This command:
- Sets up ADB reverse port forwarding (Quest → Host) so the Quest can reach your dev server
- Sets up ADB forward port forwarding (Host → Quest) for CDP communication
- If Quest Browser is already running with the URL, reloads the tab
- If a blank tab exists, navigates it to the URL
- Otherwise, launches Quest Browser with the URL
Port forwarding is idempotent - safe to run multiple times without issues.
How It Works
screenshot: Triggers
com.oculus.metacam/.capture.CaptureServicevia ADB, waits for the screenshot to save, then pulls the most recent file from/sdcard/Oculus/Screenshots/open: Uses ADB for port forwarding and browser launching. If
cdp-cliis installed, it uses CDP to intelligently reuse existing tabs instead of opening new ones.
Development
# Install dependencies
pnpm install
# Build
pnpm run build
# Run locally
node build/index.js screenshot ./test.jpg
node build/index.js open http://localhost:3000/License
MIT
