> ## Documentation Index
> Fetch the complete documentation index at: https://oxy.tech/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# A Simpler Home, Custom App Branches, Workspace Data in Airhouse, and Experiment Upgrades

> A calmer home with apps first, per-plane branches for custom apps, and data in Airhouse.

&#x20;**November 5, 2026** · v0.5.159

### New Features

#### A Simpler, Apps-First Home

The organization home has been rebuilt around two things: asking a question and opening your apps. It is rolling out to organizations on the new apps-first experience.

* **Ask first, apps big** - One column, in order: the ask box, your apps, then **Today**, then the deeper reads. The greeting and filler text are gone, and the organization's name sits in the top bar.
* **Simple and Full views** - A switch on the apps heading picks the view, remembered per organization. **Simple** (where members start) shows big app icons, with a **Recent** row once you have nine or more apps. **Full** (where owners and admins start) shows each app's freshness or newest notification, access control, recent questions and the world model.
* **Today, for the right people** - App widgets live in their own **Today** space under the apps. A calm widget with nothing to do folds to one line, progress is drawn as a ring, and widgets reach only the people they are meant for. Today is also reachable from the top bar inside any app.
* **Notification badges** - Each app shows its unread count in the corner, like a dock icon, along with its newest unread notification.
* **What changed since your last visit** - The home marks apps that have something new since you last looked.
* **A launch screen for apps** - Opening an app grows its tile into a launch screen with the app's icon and name, so opening feels immediate.
* **A minimal top bar** - The top bar holds the organization's name, Ask (⌘K) and the bell. The connection indicator appears only when you are offline, and the app-health item only while an app is down.
* **Laid out by an LLM or `oxyc`** - Widgets declare the sizes they support (regular, wide or full), and an organization's home layout, groups and widget settings can be arranged through `oxyc` or by an AI agent. Apps may now declare up to six widgets.
* **Calm motion** - A shared motion system across Oxygen and custom apps (SDK 2.24.0), so the home never jumps or shifts when widgets load.

#### Custom App Branches

Every part of a custom app can now be tested on its own copy. A staging or `dev-<handle>` sandbox environment is a **branch** with a parent, a fork point and a mode for each plane of app state:

* **Create and reset per plane** - `oxyc env create --from / --at / --preset light|full / --plane`, `oxyc env update` and `oxyc env reset --plane` control each plane, and `oxyc env show` prints the parent and each plane's mode.
* **An OLTP branch per environment** - `oltp=branch` gives an environment its own database branch cut from production at the fork point, with reset, `oxyc env diff` and automatic expiry.
* **Airhouse overlay and snapshot** - With `airhouse=branch`, a function reads back its own writes over production data without changing it. `snapshot` pins every other table to the fork point.
* **Captured messages and empty secrets and storage** - Messages are captured instead of sent (see them with `oxyc env outbox`), and secrets and storage can start empty.
* **Third-party sandboxes** - `fetch=allow --fetch-host <host>` sends write calls only to registered provider sandboxes (such as Stripe, Square, PayPal, Plaid or Toast test keys), and every call is recorded.
* **Pinned semantic model** - `semantic=branch:<b>` pins an environment's semantic model to a git branch, and a push recompiles and moves the pin.
* **Agents can check the page** - An AI agent's sandbox token can now load its sandbox's page, not only call its functions, so an agent can verify the UI without a person opening the link.

#### Workspace Data Lives in Airhouse

File-based DuckDB is deprecated in the cloud. A workspace's data now lives in its own Airhouse:

* **Automatic Airhouse tenants** - Every new workspace gets an Airhouse tenant when it is created.
* **Uploads load into Airhouse** - Uploaded CSV and Parquet files are imported into Airhouse with the same table names, so existing SQL keeps working.
* **New connection options** - Adding a database accepts Airhouse, a BigQuery key stored as a secret (`key_json_var`) and a Snowflake private key stored as a secret (`private_key_var`).

> [!NOTE]
>
> A workspace that still uses a file DuckDB (`type: duckdb` with `dataset:` or `path:`) keeps serving its current version, but its next compile is refused. Move its data to Airhouse before your next change.

#### Experiment Upgrades

* **Permutation tests for one-date runs** - Set `design.one_date_test: permutation` to compare the changed units against every unchanged one, which gives clearer results when a change touches only a few items.
* **Synthetic controls for past changes** - Retrospective runs read past data against a synthetic control instead of assuming the change was randomized, and can measure what a change left behind after it ended.
* **A clearer day-by-day chart** - The chart shades the pre window, and marks each switch date and the end date.
* **More reliable live runs** - Guardrails watch the right direction (a lever meant to lift sales no longer aborts for lifting them) and need two flagged days in a row, live runs pin the correct control units, and failed lever switches are retried.

#### SFTP Sources for Airway

An Airway `kind: filesystem` source can now read from an SFTP server (`sftp://host/dir`) with a password or private key. New landing options (`write_disposition`, `primary_key`, `version_column`, `column_types` and more) let a vendor's file drop land in Airhouse as clean, deduplicated tables.

***

### Platform Improvements

#### Custom Apps

* **Clearer failure alerts** - A failed `ctx` call's alert now names its cause, and admins can test an organization's OLTP connection.
* **Sandbox lifecycle fixes** - Leftover Airhouse copies expire from the fork date, turning on `airhouse=branch` no longer deletes an older sandbox, failed re-cuts are handled, and the environments panel shows the server's real state.
* **Browser history and sessions** - Apps that open a dialog on load can close it with Back without leaving the app, and a prefetched open no longer counts as two sessions.
* **Correct `oxyc env` examples** - Help text now suggests `storage=empty`, a mode the server accepts.

#### Airhouse

* **Deleting a workspace removes its Airhouse tenant** - A tenant still used by another workspace is never removed.
* **Steadier connections** - The connection pool reuses an idle connection before opening a new one.
* **Passwords kept out of errors** - A failed catalog attach no longer shows or logs the catalog password.

#### Fixes and Performance

* **Workspace Health hides deleted workspaces** - **Admin → Workspace Health** no longer lists deleted workspaces as "Unknown workspace" with stale verdicts.
* **No duplicate recent questions** - The home lists each recent question once.
* **Faster pre-aggregation freshness checks** - A `sql:` refresh key is now checked with one query instead of several.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.