.agentic.yml) and automations (.automation.yml) are configured
in the project. Custom apps are built with the SDK, which runs those agents
and automations but does not create them. Every app is assembled from the
same small set of SDK primitives, over the same World Model and the same
configured project, on the same hosted runtime. A new app
for a new customer is a new composition of those primitives rather than a new
stack: no backend to stand up, no authentication to implement, and no metric
definitions to rewrite.
The primitives
An app is a React + Vite bundle built with the Oxygen SDK (@oxy-hq/sdk), plus any server-side functions it ships with. The SDK
exposes a fixed set of primitives. Each one reads from or runs something
already configured in the project:
Why primitives scale
Building operating software per customer usually means rebuilding the same infrastructure each time: a backend, authentication, a data pipeline, metric definitions, and hosting. Gateway moves each of those into the platform, so the per-customer work is the part that is actually specific to the customer.- The model is shared. An app does not define its metrics. It reads them from the World Model, so every app, agent, and dashboard uses the same definitions, and a second app for another team or customer starts with them already in place.
- Cross-cutting concerns are platform features. Access rides on the viewer’s Oxygen session and is scoped to project membership, so a bundle carries no API key. Webhooks are verified before a function runs, every route invocation is rate-limited and audited, and publishing is one versioned step.
- The surface is constrained. An app reaches data only through the SDK
hooks and the function context. Each function declares its
capabilities in
oxy-app.json, every capability fails closed, andoxyc publishrefuses a function that calls one it did not declare. A bounded surface is what makes apps written quickly, including by coding agents, reviewable and safe to ship. - Data written by apps feeds the model. Facts an app records land in Airhouse in the app’s own schema, where they can be modeled as measures. The work done in an app becomes part of what the World Model can explain and control.
What’s in Gateway
Custom Apps
Operating software built on the World Model, hosted by Oxygen
Build with the SDK
Scaffold, query, and publish a React app
Agents
Multi-step agents grounded in the World Model
Automations
Multi-step workflows that load data, call APIs, and run agents