Oxy Custom Apps

Use when building, debugging, reviewing, shipping, or verifying an Oxy custom-app bundle (a code-first React/Vite app served by Oxy at /customer-apps/<org>/<slug>/), including writing Oxy Functions, driving them from the UI, and checking a published app in the browser with the Playwright MCP server (no CI checks a published bundle). Covers the oxy-app.json contract, @oxy-hq/sdk and @oxy-hq/vite-plugin, where app data goes (ctx.airhouse, ctx.oltp, ctx.storage), pitfalls, performance guardrails, load speed and usage tracking (service worker, Activity tab, useTrackEvent), the self-serve oxyc publish ship flow, dev-<handle> sandboxes and workspace previews, how an AI agent gets its own short-lived credential (oxyc tokens create --sandbox-agent or --agent, never the engineer's oxyc login), and reading a deployment's live data with oxyc api and oxyc proxy (the oxy binary has no HTTP-API commands; every one of them is oxyc).

oxy-hq Updated

File contents

oxy-hq/oxygen commit 33ee9fc0a7

Frequently asked questions

npx get-skill add oxy-hq/oxy-custom-apps