An AI toolkit that helps you build Web Apps for Meta Ray-Ban Display glasses. It contains plugins for Claude Code, Codex, Cursor, and GitHub Copilot.

Web Apps are standard HTML/CSS/JavaScript applications rendered on Meta Ray-Ban Display (MRBD) glasses — an easy and familiar way to build experiences for the glasses, especially with AI-assisted coding tools. See the full Web Apps developer documentation on the Wearables Developer Center for capabilities, design constraints, and best practices.

Claude Code:

# Add the marketplace (one-time)
/plugin marketplace add https://github.com/facebookincubator/meta-wearables-webapp

# Install the plugin
/plugin install meta-wearables-webapp@meta-wearables

# Update plugin
/plugin marketplace update meta-wearables && /plugin update meta-wearables-webapp@meta-wearables

Codex CLI:

# Add the marketplace (one-time, run in your terminal)
codex plugin marketplace add https://github.com/facebookincubator/meta-wearables-webapp

# Install the plugin (run in your terminal)
Start Codex, and type `/plugins` → tab to **[Meta Wearables]** → install.

# Update plugin

# Refresh the marketplace source
codex plugin marketplace upgrade meta-wearables

Then inside Codex: go to `/plugins` — if a newer version is available, select the option to update.

# Clone this repo and Install for your preferred tool
git clone https://github.com/facebookincubator/meta-wearables-webapp.git
./install-skills.sh claude    # Claude Code
./install-skills.sh cursor    # Cursor
./install-skills.sh copilot   # GitHub Copilot
./install-skills.sh all       # All tools + AGENTS.md

# Or remote install (no clone needed)
curl -sL https://raw.githubusercontent.com/facebookincubator/meta-wearables-webapp/main/install-skills.sh | bash

Open your project in an AI-assisted editor and describe what you want:

"Create a weather app that shows the 5-day forecast with D-pad navigation"

The AI will scaffold index.html, styles.css, and app.js following the display glasses design system.

Start your web app locally however your project requires (e.g., open index.html directly, run a dev server, npm run dev, etc.) and open it in your desktop browser. Use arrow keys to simulate D-pad input.

To test sensor data like geolocation or IMU sensors:

1. Open Chrome DevTools (F12)
2. Click the ⋮ (three-dot menu) in the top-right of DevTools
3. Go to More tools → Sensors
4. Override Location with custom latitude/longitude and change Orientation as needed

Your web app must be hosted at a publicly available HTTPS URL. This plugin supports deploying to Vercel, but Vercel is just one option — you can use any hosting provider as long as the result is a publicly accessible HTTPS URL.

Once deployed, add the web app to your glasses:

Option A — QR code (recommended):

Use the plugin's publish skill to generate a QR code. Scan it with your phone to deep link directly into the Meta AI app and add the web app to your glasses.

Option B — Manual setup:

1. Open the Meta AI app on your phone
2. Go to Devices → Display Glasses settings
3. Navigate to App connections → Web apps
4. Tap Add a web app
5. Enter the app name and your deployed URL

See the examples/ directory for sample apps:

• Snake — Classic snake game with D-pad controls and high scores

Skills are authored once in plugins/meta-wearables-webapp/skills/ and distributed via:

• Claude Code — Plugin marketplace (recommended) or install-skills.sh claude
• Codex CLI — Plugin marketplace (recommended) or install-skills.sh agents
• Cursor — Cursor plugin via install-skills.sh cursor (installs to ~/.cursor/plugins/local/, single source of truth with Claude/Codex)
• GitHub Copilot — .github/copilot-instructions.md via install-skills.sh copilot
• Gemini CLI / Windsurf / Devin — AGENTS.md via install-skills.sh agents

This project is licensed under the BSD License — see LICENSE for details.