Quickstart

Requires Node.js >=22.22.0 and npm >=10.9.0.

First time here? Signing up routes you through a short setup and a 7-day Starter trial — 20,000 credits ($20 of usage; 1,000 credits = $1), credit card required. Cancel any time before day 7 — Settings → Billing in the app, or oxygen billing cancel from the CLI — and your card is never charged.

1. Install

npm install -g @oxygen-agent/cli
oxygen login

oxygen login opens your browser: approve the terminal there (the page shows the same confirmation code your terminal printed) and the CLI connects on its own. No browser handy, or the page cannot reach your machine? Any token works from any terminal: create one under Settings → CLI sessions and run the oxygen login --token <token> command it shows. To update later:

oxygen update
oxygen status --json

2. Pick an organization

oxygen orgs list --json
oxygen orgs use <slug>
oxygen whoami --json

oxygen whoami returns the active organization plus an onboarding block. If onboarding.complete is false, load or review workspace context before asking an agent to source leads, write copy, or run paid enrichment.

3. Inspect or create a table

oxygen tables list --json
oxygen tables preview <table-id-or-slug> --limit 10 --json

To start from a CSV:

oxygen tables import --create "Starter TAM" --file leads.csv --background --json

To create an empty table:

oxygen tables create "Starter TAM" \
  --columns-json '[{"label":"Company Domain","key":"domain","data_type":"text","semantic_type":"company_domain"},{"label":"Company Name","key":"company_name","data_type":"text"},{"label":"Source","key":"source","data_type":"text"}]' \
  --json

State-changing and inspectable commands return a web_url when there is a matching web view.

4. Connect an AI assistant

Claude Desktop can connect to the hosted Oxygen MCP server at:

https://oxygen-agent.com/mcp

After connecting, ask Claude to call oxygen_whoami, then oxygen_context_resolve or oxygen_tables_list. If your agent environment does not support the hosted connector, use the CLI directly and install the agent skills:

oxygen skills install --agents codex claude-code cursor --skill '*' --json

The skills teach agents how to use the CLI/MCP surfaces safely: context first, table first, dry run before live work, and inspect runs after execution.

Day 1, week 1, day 30

You don't have to invent your own plan. Recipes are guided GTM plays — each with prerequisites, credit posture, and approval gates spelled out — organized by the question you're actually asking ("I have no pipeline", "people visit our site, then nothing", "I want LinkedIn to produce leads"):

oxygen recipes list --stage day-1 --json    # first session: knowledge + first table + first play
oxygen recipes list --stage day-7 --json    # first week: digest, warm signals, first pilot
oxygen recipes list --stage day-30 --json   # first month: review, scale, or kill

Read one with oxygen recipes show <slug> --json, or browse the catalog at oxygen-agent.com/recipes. Your agent runs the play; nothing paid or external happens without your explicit approval.

Next

• CLI - practical command guide.
• MCP - tool names, widgets, and assistant use.
• Tables - the data primitive.
• Columns - how row work happens.
• Runs - how to inspect progress, costs, and failures.