Skip to main content
Gateway is Oxygen’s software factory, the top layer of Oxygen Nexus. Pylon lands and shapes the data, and Matrix, the World Model, defines what it means. Gateway is where the operating software a business runs on is built over that model: custom apps, agents, and automations. Agents (.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, and oxyc publish refuses 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.
The result is that the marginal cost of an app falls with each one built. The infrastructure under the second app is the same as under the first, and only the composition and the customer-specific logic change.

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