Your first session
Choose how you work with OXYGEN, find your way around Home, connect the CLI, and create your first table without spending a credit.
Sign-up runs create organization (your company website is the one required field, or your company's LinkedIn page if you have no website: OXYGEN reads it once to seed your workspace knowledge) → How did you hear about us? → How do you want to work? There is no plan to pick, no trial, and no checkout on the way in.
The last step is one choice:
- Your own agent. Connect Claude, ChatGPT, Cursor, Codex or another agent through MCP or the CLI on the Install OXYGEN step, then paste the onboarding prompt it gives you into your agent.
- OXYGEN Copilot. OXYGEN's own agent, in the app, with nothing to install. Your onboarding conversation starts right away: it tells you in a few lines what OXYGEN's research found about your company, drafts your ideal customer profile for you to correct and asks what you want to build first. Then it walks you through the Get started steps one at a time: your first leads in a First leads table, a first sequence, connecting your LinkedIn account, and the launch.
You can use both later; the choice only decides where your first session starts. If the Copilot is not available to your account, sign-up goes straight to Install OXYGEN.
What the free tier gives you
The Free plan has no recurring charge or trial deadline. Eligible billing owners receive 1,000 signup credits once when signup grants are enabled, with no monthly refill. Read oxygen billing balance --json for your available balance. Live enrichment and other paid work consume credits; author and preview your outbound motion before running it. Plan prices, included credits, and what each unit costs: pricing reference.
Read oxygen billing estimate --json for your connection model. With credit_reservations, an eligible Free workspace can fund supported publishing and managed infrastructure from its balance. Connecting a sending account (a LinkedIn account, mailbox, WhatsApp number, X account or phone number) needs a plan on either model, as do plan-gated providers; new provider API keys need $99 or above after repricing, with existing-key exceptions (billing). Use Billing & credits (sidebar footer → Settings → /settings#/billing) to add credits or choose a plan. Everything you built carries over; separately funded purchases keep their own billing terms.
Reading Home
Home is where you talk to OXYGEN Copilot. Ask for what you want in your own words, or start from one of the suggested plays under the composer. Each message opens a conversation at /copilot/<id>, and your earlier conversations are listed beside it. The Copilot runs the same tools as the CLI and MCP, shows what each paid or outbound step costs, and asks before it spends credits beyond a small allowance or sends anything.
If the Copilot is not available to your account, Home shows the featured plays as prompts to copy into your own agent, your last 30 days of outreach and content, and what is running: sequences, scheduled posts and workflows.
A read-only standup of your workspace is in the terminal, 0 credits:
oxygen home --jsonThe sidebar
| Group | Item | What it holds |
|---|---|---|
Home /home | OXYGEN Copilot, or featured plays and recent activity without it. | |
| Data | CRM /crm | Companies, people, deals, and their timelines. |
| Data | Tables /tables | Working datasets — lists, enrichment, scoring. |
| Data | Unibox /unibox | Email, LinkedIn, and WhatsApp conversations in one inbox. |
| Action | Sequencer /sequencer | Outbound programs, sending accounts, analytics. |
| Action | Publishing /publishing | Scheduled posts and their engagement. |
| Action | Workflows /workflows | Deterministic multi-step automations. |
| External | Connections /connections | Provider accounts and API keys. |
| Knowledge | Tags /tags | Shared vocabulary across records, tables, and campaigns. |
| Knowledge | Observability /observability | Every run, its cost, and its provenance. |
Agents, Knowledge Graph, Recipes, and Approvals appear only once an organization turns on Beta features in Settings. Cmd-K opens a palette that jumps to any visible destination by name.
Where credits live
The sidebar footer holds the workspace switcher and a settings popover. Billing & credits (/settings#/billing) there answers every money question in one place: your plan, top-ups, seats and cancellation, and below them where credits went — by feature, provider, and day. From the CLI, oxygen billing balance --json and oxygen billing usage --json.
Connect the CLI
Home's top bar has a CLI and MCP button (Home only — other pages give that space to their own actions). It opens the same setup block as the settings popover's CLI and MCP entry at /settings/cli.
npm install -g @oxygen-agent/cli
oxygen loginNeeds Node.js 22.22.0+ and npm 10.9.0+. oxygen login opens the browser and waits; check the confirmation code matches your terminal, then click Approve this terminal.
If the handoff never completes — no browser on that box, a network that blocks the wait — the terminal prints the manual path. On /settings/cli, click Create session and paste the oxygen login --token <token> line it shows into that terminal. The token is shown once.
Confirm you are connected, against the right workspace:
oxygen whoami --json
oxygen orgs list --json
oxygen orgs use <slug>The CLI updates itself, including when a command fails with cli_update_required because it is older than the deployed API. If automatic updates are off (see Updates), run oxygen update and retry. oxygen status --json compares the two versions directly.
Using an MCP client instead of a terminal? The panel's MCP tab prints the endpoint and per-client steps; MCP setup has the full list.
A first action that costs nothing
Create a table and look at it.
Click Tables in the sidebar. An empty workspace opens the source picker straight away; otherwise click New table in the table rail (/tables/new). The picker lists every way a table can start — a file or a public link, Supabase or HubSpot, company and people searches (including lookalikes and local businesses on Google Maps), signal feeds, a webhook, a Function draft — and under each card the number of providers behind it and what a row costs, before anything runs. Pick Blank table: it creates a table named New table with one text column, Name, and opens the grid. Rename it in the breadcrumb. The grid's controls are Import rows, Add column and Export CSV in the toolbar, a magnifier in the breadcrumb that searches the rows, and New row as the last row of the grid itself — rows are appended at the bottom, where that button is.
The same thing from the terminal:
oxygen tables create "First list" \
--columns-json '[{"key":"company","label":"Company","dataType":"text"},{"key":"domain","label":"Domain","dataType":"text"}]' \
--json
oxygen tables list --json
oxygen tables preview <table-id-or-slug> --limit 10 --jsonThe create response carries a web_url. Open it and you are looking at the same grid.
Blank table and Import a CSV spend nothing. Every other card on that screen — the Total addressable market and Signals groups — runs a priced provider search, as do AI columns, enrichment columns, and sending. Those paths price the work first and wait for your approval: approvals, spend caps.