Quickstart

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

1. Install

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

oxygen login opens a browser and stores credentials for the active CLI profile. 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.

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.