oxy CLI and the Oxygen skill
for Claude Code, then deploy by connecting your repo to Oxygen Cloud.
1
Install the Oxygen CLI
The install script downloads the right binary for your OS and drops it on
your Full details and first commands: Install the CLI →.
PATH:2
Install the Oxygen skill for Claude Code
The Oxygen skill teaches Claude Code how to scaffold Oxygen files — your semantic
model, agents, automations, and data apps — correctly:
3
Build a working version locally
With the CLI and the skill in place, build your project: connect a data
source, define your semantic model,
compose your World Model, and add an
agent. Preview it locally with
oxy start --local
until it answers questions the way you want.See Connect your data → and
Your first project →.4
Push to GitHub
Commit your project and push it to a GitHub repository. Because Oxygen is
code-first, this repo is your project — Oxygen Cloud deploys from it.
5
Sign up and connect your repo
Go to app.oxygen-hq.com, sign up, and create a
workspace. Connect the GitHub repo you just pushed and Oxygen imports your
project.See GitHub integration →.
6
Re-add your secrets in the cloud
Secrets never live in git, so re-add them in the workspace after connecting:
- LLM key — Manage → Secrets. Paste your OpenAI or Anthropic key so the agents can run. (Secrets →)
- Data connections — Manage → Workspace → Connections. Re-enter the warehouse credentials your project references and click Test. (Connect your data →)
7
Ask your first question
Open the chat panel on the home page, pick your agent, and ask a question
about your data — for example:
How many orders did we get last week?Oxygen generates the SQL, runs it, and streams the answer back with the chart and the underlying query.