Skip to main content
November 19, 2026 · v0.5.161

New Features

A Redesigned Android App

The Android app has been redesigned around four simple tabs, in the same square, quiet style as the rest of Oxygen:
  • Icon tab bar - Four tabs: Home, Ask, Inbox (with an unread count) and Settings.
  • A new Home - Your organization’s apps, then what needs you: critical and time-sensitive items from each app.
  • Ask is a tab - Ask is now a full tab rather than a sheet, with suggestions and your recent conversations.
  • Apps open full screen - An app opens edge to edge, with nothing in the way.
  • Appearance that follows you - Choose System, Light or Dark once. It is the same setting Oxygen on the web and every custom app use, so a change on one carries over to the others.
  • Oxygen icon - The Android app icon is now the Oxygen logo, as on iOS.

An Admin Console That Leads With Numbers

The admin console was reorganized around the questions operators bring to it, with far less text on every page:
  • Grouped by question - The navigation has four groups, Health, Tenants, Cost & usage and Access, and four duplicate pages were folded in. Every old link still works.
  • Problems grouped by cause - The console home lists what needs attention, worst first, and groups repeated failures under one cause instead of listing them row by row.
  • Numbers first - Pages lead with a strip of numbers, zeros fade into the background, and explanations sit behind an ⓘ instead of in paragraphs.
  • One table for Airway source kinds - Each source kind is one line, edited in place, instead of a tall form.

Tokens and Secrets in One Place

Settings used to spread credentials over four pages. Now there are two, both under Organization, and a secret can be shared instead of copied:
  • API tokens - Personal access tokens, service accounts, every token in the organization and the token policy, all on one page. A Which token do I need? guide suggests the right kind of token for what you’re doing.
  • Secrets - Shared secrets and single-app secrets are both here, and you can create a service account token straight into a secret without copying and pasting it.
  • Share with apps - Pick which apps can read a secret. Each app reads it in ctx.env under its own name, and a change of value reaches every app on its next call.
  • See who reads what - The secrets list has an Available to column, search across secret and app names, and filters for shared, organization-only and single-app secrets.
  • Fill in missing keys in one click - A panel lists the keys each app declares but doesn’t have yet, so you can share an existing secret with an app or create a new one with its name already filled in.
  • An app’s own value still wins - If an app has its own value for a key, it is used instead of the shared one. A promote counts a shared secret as set.
Legacy API keys (oxy_ followed by 32 hex characters) no longer work. A request that uses one gets a 401 naming the replacement. Create an API token under Organization → API tokens and send it in the Authorization header, or in X-API-Key as before.

A Console for Every Custom App

Each custom app’s console is now a set of short pages (Overview, Activity, Functions, Events, Releases, Data, Secrets and Settings), each leading with its numbers, and it shows much more of what is going on:
  • Clear environment - A strip at the top shows whether you’re working on production, staging or a sandbox. Functions, Run now, invocations and secrets all follow it, and the console uses Production, Staging and Promote to production throughout.
  • Invocation explorer - Every function’s invocations in one place over 24 hours or 7 days, filterable by function and outcome, compared with the previous window.
  • Schedules and checks - See when each schedule fires next and whether its last run worked, and whether the app’s checks pass in production and staging.
  • App map - See what starts each function and what its recent runs touched.
  • Data browser - Browse an app’s own OLTP data, read-only.
  • Events - A new page for the app’s message queue: pending, retrying and dead deliveries, with dead letters grouped by cause.
  • Function input and output schemas - Generated from the function’s TypeScript and checked by the console.
  • Publish timings - Each publish stage is timed, and failed publishes are recorded and shown alongside successful ones.

Safer Promotion to Production

  • Every path to production is checked - oxyc publish --promote, including publishes from CI, now hits the same blockers as Promote, such as a required secret that is missing in production or a production schedule that hasn’t been confirmed.
  • Optional second-person rule - An app can require that whoever published a build, whether a person or a CI job, is not also the one who puts it in production.

Custom Apps Act in Oxygen Without a Stored Key

A custom app’s function can now take actions in Oxygen itself, such as managing devices or reporting an upload, without a stored API key:
  • Ask in the manifest - The app lists the actions it needs in oxy-app.json.
  • Approved once by an admin - An organization owner or admin approves the request once in the browser.
  • Call ctx.oxygen.* - The function calls Oxygen directly, as the app’s own service account. Anything the manifest doesn’t ask for, or an admin hasn’t approved, is refused.

Keyless Access for Services and CI

Services and CI pipelines can now get access to Oxygen without anyone handling a long-lived token:
  • Trusted OIDC issuers - An organization can register any OIDC issuer, such as AWS IAM, and add trust policies saying which of its identities may act as which service account. A service exchanges the identity token its platform gives it for a short-lived Oxygen token, so no key is stored anywhere.
  • oxyc init-ci sets itself up - When the CI service account or trust policy is missing, one browser approval from an organization admin creates both, instead of a list of manual steps.
  • oxyc tokens create --org-service-account - Creates (or reuses) an organization service account and mints its token after an admin approves in the browser. --set-app-secret writes the token straight into a custom app’s secret, so it never appears on screen.

Addresses Name the Organization

Page addresses no longer include a workspace ID. A thread is now at /<org>/threads/<id> rather than /<org>/workspaces/<id>/threads/<id>. Old links in emails, Slack messages, notifications and bookmarks still work and redirect to the new address.

Custom App SDK Theme and Phone Kit

  • Reference design as a theme - @oxy-hq/sdk/theme.css (SDK 2.29) brings the Oxygen reference app’s design to any custom app, and the SDK shell and phone kit read it. It is opt-in, so apps that don’t import it look the same.
  • Overlays blur the page - SDK overlays blur the page behind them, and the shell’s Ask is a secondary button.
  • Phone kit polish - Sheets keep their scroll position, section titles line up, controls fit on 320px screens, the current tab is shown in the accent blue, side panels run the full height of the window, and the drawer’s appearance control is a single row.

New Airway Sources and Resources

  • Amazon Ads - A new amazon_ads source with sp_search_term and sp_placement reports.
  • Amazon FBA fee preview - The sp_api source adds fba_fee_preview with per-SKU referral and FBA fees, and orders now re-reads 29 days so orders that stay pending longer are updated in the warehouse.
  • NetSuite item locations - NetSuite pipelines can opt into item_locations.

Developer Portal Files Tree

The read-only Files tree has a filter box and keyboard navigation (arrow keys, Home/End and Enter), and can expand or collapse every folder at once.

Coming Soon: App Events

Custom apps will soon be able to talk to each other. One app’s function will publish a typed event that functions in other apps can listen for, react to table changes, and call another app’s function directly with ctx.apps.call or queue it with ctx.apps.send. This is being rolled out to selected organizations first.

Platform Improvements

Organizations

  • Apps-first for every organization - The apps-first experience is now how Oxygen works for every organization, rather than a per-organization setting.
  • New organizations start with no workspace - A new organization’s workspace is created when its GitHub repository is connected. Until then the organization shows a “being set up” screen, and the Demo and Blank workspace options are gone.

Workspaces and Compile

  • Faster semantic model reads - Compiled workspaces stay cached instead of being rebuilt every minute, and revisions with identical semantic files share a single cache, so queries after a compile stay fast.
  • Compile always reads from git - Every compile now builds from the workspace’s repository, and compile checks the semantic model.
  • Compiles no longer get stuck - A compile that no server could pick up no longer blocks later compiles, and Cancel now closes it.
  • Clearer failed-compile status - The compile status waits for a failed compile’s reason before reporting it.

Custom Apps

  • Sends act as the sender - An app-to-app send is delivered as the person who sent it, with their permissions checked again at delivery time.
  • Deleting an app cleans up - Deleting an app is now recorded in the audit log, and its usage data is purged.
  • Functions run where they should - Functions on a workspace with a file database run on any server, and no longer fail with a server error when no Factory is configured.
  • oxyc publish with event schemas - Re-publishing a --dir bundle now includes an edited event schema.

Agents and Chat

  • Agent answers with Anthropic models - Analytics agents on Anthropic models without a semantic model no longer fail with a 400 error.
  • Chats survive a server restart - A chat run left behind by a server that stopped is picked up and finished by another one.
  • Latest revision served - Background workers pick up a newly promoted revision instead of serving an old one.
  • Scheduled background jobs on the worker fleet - The custom app storage cleanup and other scheduled jobs now run on the worker fleet.

Security

  • SQL kept out of logs - Queries run in the Developer Portal’s SQL client are no longer written to logs in full, and error reports keep only the query’s shape.

oxyc

  • Device login keeps waiting - oxyc login by device code keeps waiting for approval, and its link is the only step needed.
  • -q exit codes - oxyc api … -q keeps jq’s exit status even when jq exits before reading all of its input.
  • Cloud network secrets - OXY_TOKEN=from-proxy lets oxyc run in cloud sessions where the token is added by a network proxy and never stored on the machine.

Fixes

  • Factory opens cleanly - The Factory opens without a flash, and its top bar can switch workspaces.
  • Apps without rows no longer crash - Custom app data reads that return no rows no longer crash the app.