Surfaces
CLI command reference
Every public oxygen command, generated from the CLI's own command tree.
Every public command the oxygen CLI registers — over 900 commands across 90 groups — generated from the CLI's own self-index (oxygen commands --json, which returns the exact total for the version you have installed). Hidden compatibility commands stay executable but are omitted from this discovery surface. Run oxygen commands get "<command>" --json for one public command's full description, arguments, and flags.
Markers in Notes:
| Marker | Meaning |
|---|---|
paid | Some invocation mode spends credits or performs an approval-gated external write. |
writes | Mutates workspace, provider, or account state. |
staff | OXYGEN staff only; a customer identity is refused. |
deprecated | Retired, removed, or superseded — kept listed so the replacement is discoverable. |
alias | A second spelling of another command. |
A blank Notes cell means the command is read-only and free.
action-column
| Command | What it does | Notes |
|---|---|---|
oxygen action-column add-provider | Add a catalog-backed provider action picker column to a workspace table. | writes |
admin
| Command | What it does | Notes |
|---|---|---|
oxygen admin automation-usage divergences | List every automation-usage window whose counter and event ledger disagree, including windows that have outlived the detector's lookback and can only be cleared by a repair. | staff |
oxygen admin automation-usage reconcile | Write the one audited adjustment that closes a window's counter/ledger divergence. | writes staff |
oxygen admin costs | Show provider costs (COGS) per workspace. Staff only. | staff |
oxygen admin directory delist | Remove an organization's listing from the public directory (kill switch). | writes staff |
oxygen admin directory enable | Invite an organization to the directory, optionally prefilling its profile. | writes staff |
oxygen admin directory list | List every agency directory listing across all organizations. | staff |
oxygen admin egress | Read-only Fly email-egress overview: shared IP, dedicated workspace apps and IPs, liveness, image drift, billing, and stuck orders. OXYGEN staff only. | staff |
oxygen admin kpis | Show company acquisition with self-reported signup-channel attribution, signup-to-CLI/MCP activation, matured seven-day trial conversion, positive-paid MRR/ARR, and paid churn separated from trial… | staff |
oxygen admin primary-providers | Board of the PRIMARY managed external data providers (enrichment, people/company search, web search, scraping, signals, AI-column web grounding, LLM inference): per provider health probe, 7d… | staff |
oxygen admin spend | Global managed-provider spend limiter: burn, ceilings, breakers. Staff only. | staff |
oxygen admin spend halt | Force a breaker OPEN — the platform kill switch for managed provider spend. --scope managed_credit --key <provider> benches Oxygen's managed account for one provider (the same bench a vendor 402… | staff |
oxygen admin spend resume | Close a breaker and clear its backoff, resuming managed provider spend. | writes staff |
oxygen admin spend set-limit | Set a ceiling for one scope + window. action=warn meters only; block arms it. | writes staff |
agent
| Command | What it does | Notes |
|---|---|---|
oxygen agent approval-decide | Approve or reject one pending Workspace or custom Agent tool call, then resume its durable run. | |
oxygen agent cancel | Request cancellation of an active Workspace or custom Agent run. | writes |
oxygen agent create | Create a custom Agent and publish its first immutable version. This internal configuration write starts no chat/run and spends no credits. | writes |
oxygen agent custom | List the org's user-defined custom agents (distinct from agent list, which shows the built-in roster). | |
oxygen agent delete | Archive a custom agent (soft delete): its triggers stop firing and it leaves the roster; versions/runs are preserved. | writes |
oxygen agent disable | Disable a workspace or specialist agent so it stops new runs on the next worker tick. | writes |
oxygen agent enable | Enable a workspace or specialist agent so it resumes its governed runs. | writes |
oxygen agent file-create | Store a tenant-owned text file for Agent context and sandbox input. | writes |
oxygen agent files | List tenant-owned Agent context files. | |
oxygen agent get | Show one agent — the Workspace Agent, a specialist, or a custom agent — with its active version and recent runs. | |
oxygen agent list | List the Workspace Agent and built-in specialists with state and recent run history. | |
oxygen agent run | Start a durable chat/run for the Workspace Agent or a custom Agent on the Fly worker. | paid writes |
oxygen agent run-get | Inspect one Workspace or custom Agent run and its append-only event ledger. | writes |
oxygen agent runs | List recent runs across all agents (or one via <slug>), newest first. | |
oxygen agent set | Publish an immutable version (reconfigure) for a runtime agent: the Workspace Agent or a custom agent. | writes |
oxygen agent trigger-create | Create a cron, internal event, or signed-webhook trigger for the Workspace Agent. | paid |
oxygen agent trigger-set | Activate, pause, or archive one Workspace Agent trigger. | |
oxygen agent triggers | List Workspace Agent cron, internal event, and webhook triggers. A legacy cron held to the plan minimum includes slowed_to_plan_minimum and its next run time. |
api-keys
| Command | What it does | Notes |
|---|---|---|
oxygen api-keys create | Create a CLI API key. The token is shown once. | writes |
oxygen api-keys list | List active CLI API keys for the current user and organization. | |
oxygen api-keys revoke | Revoke a CLI API key for the current user and organization. | writes |
approvals
| Command | What it does | Notes |
|---|---|---|
oxygen approvals cancel | Withdraw a pending request you filed (or, as an admin, clear a stale one). | writes |
oxygen approvals client grant | Restrict a member to the client role. | writes |
oxygen approvals client list | Every member of this workspace and what they may do — the workspace role plus the Oxygen client overlay — followed by anyone invited who has not joined yet, and what they will land as. | |
oxygen approvals client revoke | Clear the client role and restore full workspace access. Works on a pending invitation too, clearing what that address would land as. | writes |
oxygen approvals decide | Answer a pending request. | writes |
oxygen approvals gate list | Which gates this workspace requires. | |
oxygen approvals gate set | Require (or stop requiring) an approval before the live action. | writes |
oxygen approvals inbox | What is waiting on YOU: pending approvals assigned to you plus open threads that name you, each with the command that answers it. This is the surface a client logs in to. | |
oxygen approvals list | Approval requests in this workspace, newest first. Use --mine for the ones assigned to you, or approvals inbox for the daily view. | |
oxygen approvals request | Ask a named second party to decide. | writes |
oxygen approvals show | One approval request by its own id: what is being asked, on what, by whom, who must decide, and whether it can still be decided at all. |
auth
| Command | What it does | Notes |
|---|---|---|
oxygen auth doctor | Diagnose the active Oxygen CLI credentials without printing token material. | |
oxygen auth use-token | Store a CLI API token non-interactively. | writes |
billing
| Command | What it does | Notes |
|---|---|---|
oxygen billing allowance | Show this billing cycle's credit pool as one breakdown: fixed spend, flexible spend, credits committed to the next renewal, and what is free to spend — the numbers behind the bar on the… | |
oxygen billing audit | Summarize where managed credits were granted, reserved, captured, released, or spent. | |
oxygen billing balance | Show the current plan, whether yearly billing is offered (annual_billing_available), subscription entitlement, and managed credit balance: available and reserved credits, FIXED credits committed… | |
oxygen billing cancel | Schedule the plan subscription to cancel at period end. | writes |
oxygen billing change | Create a Stripe approval link to start a first plan or change an existing plan, and return that link (approval_url), with the target plan's monthly credits (target_plan). | |
oxygen billing commitments | List the fixed monthly credit commitments blocked at your subscription renewal — per connected sending mailbox, OXYGEN-sold mailbox, warm-up, deliverability, connected LinkedIn, WhatsApp and X… | |
oxygen billing estimate | Estimate what a month of outreach costs before you build it: leads × enrichment × sequence steps × senders. | |
oxygen billing grant | Grant managed credits to the current organization (staff only). | writes staff |
oxygen billing invoices | List every invoice Stripe has issued for this workspace, newest first, each with a direct PDF link. | |
oxygen billing reconcile-paid-period | Find active subscriptions whose current billing period was paid in Stripe but never had its plan credits minted, and restore them (staff only). | writes staff |
oxygen billing resume | Remove a scheduled cancellation so the subscription renews (or the trial converts) normally. Free (no fee, no credits). Prints the next charge date and amount. | writes |
oxygen billing seats | Show sending capacity per channel: how many seats are purchased, how many are grandfathered, how many senders are connected, and how many are left. | |
oxygen billing seats set | Set how many sending seats of one channel this workspace holds. | writes |
oxygen billing set-plan | Create or update an off-Stripe custom plan for an organization (staff only). | writes staff |
oxygen billing topup | Buy a custom amount of on-demand credits. | |
oxygen billing usage | Show credit ledger events (each tagged with its FIXED/FLEXIBLE spend_class), workflow step usage (automation_actions: credits per step, credits billed; writing rows is free), calls with your own… |
blueprints
| Command | What it does | Notes |
|---|---|---|
oxygen blueprints apply | Apply a blueprint: 0 credits and no provider calls or external writes, but creates workspace tables, columns, prompts, and a disabled workflow. | writes |
oxygen blueprints archive | Archive a saved blueprint (seed blueprints cannot be archived). | writes |
oxygen blueprints describe | Describe one blueprint (seed or saved) by slug. | |
oxygen blueprints export | Build a portable blueprint JSON from an existing workflow. | |
oxygen blueprints list | List Oxygen blueprints visible in this workspace (seeds + saved). | |
oxygen blueprints marketplace | Browse the public Oxygen blueprint marketplace. | |
oxygen blueprints preflight | Preflight a blueprint (slug, local file, or shared URL) against this workspace. | |
oxygen blueprints publish | List a blueprint on the public Oxygen marketplace. Auto-creates a share URL if none exists. | paid writes |
oxygen blueprints save | Persist a blueprint envelope into this workspace's gallery. | writes |
oxygen blueprints share | Create a public share URL for a saved blueprint (oxygen-agent.com/b/<code>). | writes |
oxygen blueprints shares | List existing share URLs for this workspace. | |
oxygen blueprints tag | Replace a saved blueprint's workspace tags (whole set; --tags "" clears). Works on already-saved blueprints — no re-export needed. See oxygen tags list for the vocabulary. | writes |
oxygen blueprints unpublish | Remove a blueprint from the public marketplace. The share URL stays valid for direct visitors. | writes |
oxygen blueprints unshare | Revoke a public share URL by short code. | writes |
budget
| Command | What it does | Notes |
|---|---|---|
oxygen budget delete | Delete a standing budget policy by id. | writes |
oxygen budget list | Read-only, 0 credits. | |
oxygen budget set | Set, raise, or lower a standing credit cap (idempotent per scope+window). Daily/monthly windows start at 00:00 UTC and count reservations minus releases; inspect current use with oxygen budget list. | paid writes |
callables
| Command | What it does | Notes |
|---|---|---|
oxygen callables bind | Add a callable-function column to a source table with explicit input and callback mappings. | paid writes |
oxygen callables describe | Describe a callable's typed input/output contract and pinned backing columns. | |
oxygen callables disable | Disable new invocations without changing existing tables or in-flight runs. | writes |
oxygen callables enable | Enable a callable table. | writes |
oxygen callables list | List published callable tables and their current credit posture. | |
oxygen callables publish | Publish an existing table as a versioned callable function. | paid writes |
capabilities
| Command | What it does | Notes |
|---|---|---|
oxygen capabilities get | Hydrate one exact capability card by id. | |
oxygen capabilities search | Find the owning capability, boundary, gateways, and next hydration step. |
cells
| Command | What it does | Notes |
|---|---|---|
oxygen cells history | Show cell change history. | writes |
oxygen cells inspect | Inspect one cell's value, row context, and recent history. | |
oxygen cells resolve | Record what a human verified about a cell whose external write was dispatched but never confirmed. | writes |
columns
| Command | What it does | Notes |
|---|---|---|
oxygen columns add | Add a nullable column to a workspace table. | writes |
oxygen columns archive | Archive a workspace column without dropping physical data. Hides it indefinitely with no purge timer; for cleanup with a restorable deadline use columns delete. | writes |
oxygen columns catalog | List the column templates you can add with columns add <table> --prompt-key <key>: the extract templates (pricing-page, job-posting, event, 10-K, website-fact, market and text extractors) and… | |
oxygen columns convert | Convert a column between an AI column and a Web Research Agent column (--to agent or --to ai), or switch an agent to Keyword search and back. | writes |
oxygen columns delete | Delete workspace columns: archives now, frees the key for reuse, and schedules the physical purge (default 14 days; restorable via columns restore until then). --now purges immediately and… | writes |
oxygen columns deps | Show the column dependency graph: which columns feed which (formulas, input mappings, run conditions, waterfall targets), transitive up/downstream, and cycles. Read-only. | |
oxygen columns fields | List what a column's output exposes: every field you can reference as {{column.field}}, filter on, sort by, or promote to its own column with columns materialize. | |
oxygen columns materialize | Copy JSON paths from a result column into existing or new target columns. | writes |
oxygen columns rename | Rename a workspace column key and optionally label. Warns when another column reads the old key — a rename does not rewrite the references pointing at it. | writes |
oxygen columns reorder | Move a workspace column to a new position, by absolute index or relative to another column. | writes |
oxygen columns rerun | Re-run a single AI column cell, optionally threading a prior message review's feedback into the prompt. | paid writes |
oxygen columns restore | Restore an archived or delete-scheduled column: cancels the purge timer and reclaims its key. | writes |
oxygen columns retype | Convert a manual text column to a stronger data type, migrating stored values. | writes |
oxygen columns run | Run an executable AI, tool, formula, enrichment, bind, lookup, or custom HTTP column for one row or a bounded batch. | paid writes |
oxygen columns update | Update a workspace column: label and visibility, and for AI/research columns the prompt, named inputs, model, reasoning level, run condition, output schema, and web-research settings. | writes |
commands
| Command | What it does | Notes |
|---|---|---|
oxygen commands | Discover CLI commands. With no subcommand, print the backwards-compatible full manifest. | |
oxygen commands get | Hydrate one exact CLI command with its arguments, flags, and safety markers. | |
oxygen commands search | Find a bounded set of CLI commands from a natural-language outcome. |
comments
| Command | What it does | Notes |
|---|---|---|
oxygen comments add | Comment on a workspace object. | writes |
oxygen comments delete | Retract one of your own comments. AUTHOR ONLY, idempotent. The row stays so the thread remains a complete audit trail; the text is redacted on every read path. | writes |
oxygen comments edit | Rewrite one of your own comments. AUTHOR ONLY. The edit stamps edited_at — a thread that decided a launch is evidence, and evidence that changes without a trace is not evidence. | writes |
oxygen comments list | Every comment thread on one object, newest first, with its comments inline. Defaults to open threads only. | |
oxygen comments resolve | Mark a thread settled, or reopen it with --reopen. Idempotent both ways: re-resolving keeps the original resolver and timestamp. This is conversation state only — it never unblocks an approval gate. | writes |
oxygen comments show | One thread by its own id, with every comment. |
companies
| Command | What it does | Notes |
|---|---|---|
oxygen companies enrich preview | Inspect missing company fields, provider routing, and credit estimates without provider calls. | |
oxygen companies enrich run | Queue a live company enrichment waterfall after explicit approval, or return a dry-run plan. | paid writes |
oxygen companies search filters | List Company Search filter fields and options without a provider call, including every enum field's full accepted-value list. --source hiring lists the Job postings filters instead (job.* and… | |
oxygen companies search plan | Compile a company-search prompt into ordered provider routes without provider calls. | |
oxygen companies search preview | Preview up to 50 rows free, using native filters from companies search filters. --source google_maps previews 20 businesses with a q business-and-area filter; total_results is unavailable when the… | |
oxygen companies search run | Return a dry-run request or queue a live company-search ingestion run. | paid writes |
connections
| Command | What it does | Notes |
|---|---|---|
oxygen connections import | Start (or re-arm) a connections import. | writes |
oxygen connections status | Show connections-import progress (per-sender drip status, connections ingested, last error) plus a preview of the connections table and a deep-link to open it. |
context
| Command | What it does | Notes |
|---|---|---|
oxygen context assets archive | Archive a context asset. | writes |
oxygen context assets get | Read one context asset. | |
oxygen context assets list | List workspace context assets. | |
oxygen context assets search | Full-text 'second brain' search across context assets, ranked by relevance. | |
oxygen context assets set-default | Pin a context asset as the canonical default for its type. The canonical brand/voice/positioning docs are auto-applied to AI copy generation. | writes |
oxygen context assets upsert | Create or update a context asset. | writes |
oxygen context profile get | Read the current workspace company profile. | |
oxygen context profile update | Merge one or more profile sections into workspace GTM memory. | writes |
oxygen context resolve | Resolve task-scoped workspace GTM context with readiness and revision provenance. | writes |
copilot
| Command | What it does | Notes |
|---|---|---|
oxygen copilot approve | Approve (or, with --reject, reject) an action a Workspace Copilot session is waiting on; approving re-queues the paused turn. | paid writes |
oxygen copilot attach | Attach a file to a Workspace Copilot session without sending a message yet. | writes |
oxygen copilot attachments | List the files attached to a Workspace Copilot session, sent and unsent. | |
oxygen copilot cancel | End a Workspace Copilot session for good, stopping any in-flight turn. The session cannot take new messages afterwards — to stop only the current turn, use copilot interrupt. | writes |
oxygen copilot follow | Turn screen-follow ON (or, with --off, OFF) for an open Workspace Copilot session: while it is open in the browser, your screen opens onto whatever the copilot creates or changes, with the live… | |
oxygen copilot get | Show one Workspace Copilot session: its state, turns, and event log. Use --after-seq to page through the event stream. | |
oxygen copilot interrupt | Stop the turn a Workspace Copilot session is currently working on, leaving the session open for your next message. | writes |
oxygen copilot list | List your Workspace Copilot sessions and their current status. | |
oxygen copilot plan | Show how far along a Workspace Copilot session is: its plan's major steps, the substeps under each, what is done, and how much longer the rest is expected to take. | |
oxygen copilot send | Send a message to a Workspace Copilot session and stream the reply to stderr. | paid writes |
oxygen copilot start | Start an attended Workspace Copilot session on Oxygen Auto — Oxygen picks the model, keeps one conversation on one model, and runs its own errands on a cheaper one. | writes |
crm
| Command | What it does | Notes |
|---|---|---|
oxygen crm activity log | Log a timeline activity on a CRM record. Defaults to dry-run. | writes |
oxygen crm activity note | Log a free-text note on a CRM record. Defaults to dry-run. | writes |
oxygen crm activity timeline | Show a CRM record's activity timeline, newest first. Address the record by row id OR by any of the object's identities — a company domain, a person's email or LinkedIn URL. | |
oxygen crm assert | Create or update one CRM record by object identity. | |
oxygen crm automation audit | Show recent CRM automation rule changes, newest first. | |
oxygen crm automation rules | List the standing CRM automation templates and their armed state. | |
oxygen crm automation set | Arm or disarm a standing CRM automation template. | paid writes |
oxygen crm connections | Show the conversations and sequence enrollments connected to one CRM record, resolved through its people and identities — never by fuzzy name or domain. | |
oxygen crm describe | Describe one configured CRM object: its fields, identities and relationships. Pass --field <key> to read just one field (its name, type, choices, flags) instead of the whole object. | |
oxygen crm duplicates | List ranked duplicate-candidate record pairs for one CRM object (identity-overlap + fuzzy-label). Read-only. | |
oxygen crm enrichment backfill | Enrich the records you ALREADY have. | paid writes |
oxygen crm enrichment disable | Disarm one enrichment on a CRM object and leave every other choice untouched. New records stop running its columns; already-written values stay. | writes |
oxygen crm enrichment enable | Arm one enrichment on a CRM object and leave every other choice untouched. | writes |
oxygen crm enrichment list | Show the enrichments available per CRM object: which are armed, what each costs per record, the per-record total, the per-batch credit ceiling, how much of the column allowance is spent, and how… | |
oxygen crm enrichment off | Turn automatic enrichment off for a CRM object: revokes the standing permission and clears the WHOLE configuration — every named preset plus any columns you added to it yourself, so nothing keeps… | writes |
oxygen crm enrichment set | Replace the armed enrichment set for a CRM object outright — any preset not listed is disarmed, while columns you added to the config yourself are kept. | paid writes |
oxygen crm fields | Fill the stored CRM fields (Industry, Employees, HQ, and their siblings) from enrichment data this workspace already holds. | |
oxygen crm files attach | Upload a local file and attach it to a CRM record. Attaching the same file twice is a no-op, not a duplicate. | writes |
oxygen crm files detach | Remove a file from a record. Removes the LINK only — the stored file is kept, so anywhere else it is attached still has it. | |
oxygen crm files list | List one record's attachments, newest first. | |
oxygen crm get | Get one CRM record aggregate with row values, identities, and relationships. | |
oxygen crm merge | Merge two CRM records: survivor-wins-with-loser-fill field write + relink/tombstone. Defaults to dry-run; --live requires --confirm. | writes |
oxygen crm notes add | Write a note on a CRM record. | writes |
oxygen crm notes delete | Delete a note. Soft: the note stops showing its text while its place in the timeline stays, so the record still shows that a note was written and removed. | writes |
oxygen crm notes list | List one record's notes, pinned first then newest. Address the record by row id OR by any of the object's identities. | |
oxygen crm notes update | Edit a note's body, title or pin. Addressed by note id because one note can be filed on several records. | writes |
oxygen crm objects | List configured CRM objects, or create/extend custom objects. | |
oxygen crm objects add-attr | Add one field to an existing CRM object, optionally as an identity. Works on custom objects and on companies/people/deals — a field you add is yours and survives crm setup. Defaults to dry-run. | writes |
oxygen crm objects create | Create or repair a custom CRM object. Defaults to dry-run. | writes |
oxygen crm objects delete | Delete a CUSTOM CRM object: removes the object and schedules its backing table for deletion (restorable for 14 days). | writes |
oxygen crm objects remove-attr | Remove a field you added to a CRM object. | writes |
oxygen crm objects update-attr | Change one field on a CRM object: rename it, make it required or optional, or replace the choices of a select/status field. | writes |
oxygen crm photos | Fill CRM people photos from LinkedIn data this workspace already holds — inbox conversations, connections, followers, and post engagers. | |
oxygen crm pipeline | Show the deals pipeline grouped by stage, with per-stage counts and amount totals. | |
oxygen crm related | Show the records linked to one CRM record, grouped by relationship with a true count per group. | |
oxygen crm relationships define | Define a relationship (and its relation column) from a custom object to any object. Defaults to dry-run. | |
oxygen crm relationships upsert | Create or replace a CRM relationship edge. Defaults to dry-run. | writes |
oxygen crm rollup | Recompute the Open Deal column on companies (and the copy stamped on their people) from this workspace's deals. | |
oxygen crm search | Search CRM records by identity or record label. Takes ONE query; narrow the objects with --object, not a second argument. | |
oxygen crm setup | Create or repair standard CRM object-backed tables. Defaults to dry-run. | writes |
oxygen crm signals leads-today | List people to contact today, ranked by their most recent GTM intent signal. | |
oxygen crm signals record | Record one inbound GTM signal (website_visit, profile_view, post_engager, new_follower) into the CRM. Internal write — free, no approval. Idempotent on --external-event-id. | writes |
oxygen crm sync configure | Configure a standing bidirectional sync for one CRM object pair. | paid writes |
oxygen crm sync disable | Disable the scheduled sync for one CRM object pair: stops the cron trigger and revokes the standing write permission. | writes |
oxygen crm sync enable | Enable continuous (scheduled) bidirectional sync for one CRM object pair: arms the cron trigger + the standing write permission, and runs an immediate first cycle. | paid writes |
oxygen crm sync import | Import provider records into an Oxygen CRM object (canonical CRM truth) as a durable workflow run. | paid writes |
oxygen crm sync links | Show provider record links (HubSpot/Attio ids) mapped to one Oxygen CRM record. | |
oxygen crm sync run | Run one bidirectional reconciliation cycle for a configured CRM object pair as a durable workflow run. Defaults to dry-run. | paid writes |
oxygen crm sync status | Show a CRM sync status: pass --run-id for one workflow run, or --provider/--object for the standing sync config (cadence, watermarks, last-cycle counts). | |
oxygen crm tag | Add/remove workspace tags on one CRM record (Tags primitive — the same vocabulary as sequences, tables, conversations; see oxygen tags list). | writes |
oxygen crm tasks add | Create a task on a CRM record. | writes |
oxygen crm tasks complete | Mark a task done. Completing an already-completed task keeps the original completion time and adds no second timeline entry. | |
oxygen crm tasks list | List open reminders across the whole workspace, or one record's with <object> <record>. | |
oxygen crm tasks reopen | Reopen a completed task, clearing its completion stamp. | |
oxygen crm tasks update | Change a task's title, body, status, priority, deadline or assignee. Addressed by task id because one task can be filed on several records. | writes |
custom-integrations
| Command | What it does | Notes |
|---|---|---|
oxygen custom-integrations apply | Create or update a custom HTTP integration manifest. Attach credentials with custom-integrations connect. Manifest schema + worked examples: https://oxygen-agent.com/docs/providers/custom-http | writes |
oxygen custom-integrations connect | Attach the credential (bearer token, API key, or basic password) for an applied custom HTTP integration. | writes |
oxygen custom-integrations list | List custom HTTP integrations for the active organization. |
dashboards
| Command | What it does | Notes |
|---|---|---|
oxygen dashboards create | Create a saved dashboard. It starts with one empty tab; add widgets to it with dashboards widgets add. | writes |
oxygen dashboards delete | Archive a dashboard. Its slug becomes free to reuse; the definition is kept, not destroyed. | writes |
oxygen dashboards get | Read one dashboard with its tabs and widgets. | |
oxygen dashboards list | List the dashboards saved in this workspace. | |
oxygen dashboards summary | Show the GTM funnel summary: touches → replies → positive → meetings → deals → won, with this-period revenue, channel split, and needs-action triage counts. | |
oxygen dashboards tabs add | Add a tab to a dashboard. | writes |
oxygen dashboards tabs remove | Remove a tab and every widget on it. A dashboard always keeps at least one tab. | writes |
oxygen dashboards update | Rename a dashboard, change its description or icon, or make it the default. | writes |
oxygen dashboards widgets add | Add a widget. Kinds: chart, view, iframe, rich_text, code, live_source. The configuration shape depends on the kind — run oxygen dashboards widgets kinds to see each one with an example. | writes |
oxygen dashboards widgets data | Read the data behind one widget — the same numbers the web page draws. | |
oxygen dashboards widgets kinds | List the widget kinds, what each one shows, whether it can cost credits, and an example configuration. | |
oxygen dashboards widgets refresh | Refresh a live-source widget now. This is the only dashboard command that can cost credits, bounded by the ceiling saved on the widget. Opening a dashboard never spends. | writes |
oxygen dashboards widgets remove | Remove a widget from a dashboard. | writes |
oxygen dashboards widgets update | Change a widget's title, configuration or placement, or pause/resume a live source. | writes |
db
| Command | What it does | Notes |
|---|---|---|
oxygen db attach | Attach an existing Postgres database as the current organization's tenant database. | writes |
oxygen db backfill-table-order-indexes | Converge stable row-order indexes on existing customer tables. Staff only; the default dry-run uses 0 credits and makes no database changes. | writes staff |
oxygen db backfill-upsert-indexes | Create missing upsert-key secondary indexes on customer tables. Staff only; defaults to dry-run. | writes staff |
oxygen db cost-policy | Show the historical Neon cost-policy record. PostgreSQL hosting has no Neon endpoint controls. | |
oxygen db migrate | Apply pending tenant database migrations for the current organization. | writes |
oxygen db migrate-all | Apply pending tenant database migrations across all ready tenants (staff only). | writes staff |
oxygen db provision | Provision the current organization on a registered PostgreSQL shard. Staff can pass global --org to repair another org. | writes |
oxygen db query | Run one read-only SQL statement against the current tenant database. | |
oxygen db reconcile | Inspect tenant database registry drift. Staff only; defaults to dry-run. | writes staff |
oxygen db reconcile-cost-policy | Retired compatibility command: report that Neon endpoint controls no longer apply. | writes deprecated |
oxygen db repair-preview | Preview tenant database repair issues without mutating production state (staff only). | staff |
oxygen db status | Show the current database provider and status. Hosting is included in your plan; Neon IDs on a PostgreSQL row are historical lineage. Staff can pass global --org to inspect another org. |
deliverability
| Command | What it does | Notes |
|---|---|---|
oxygen deliverability placement-test get | Inspect one saved directional inbox-placement test by id: status, seed counts, per-provider results, and a web result link. | |
oxygen deliverability placement-test list | Inspect recent directional inbox-placement tests, their status, results, and credits used, plus pricing: the EmailGuard monitoring credits per inbox-month and the managed test price in force (0… | |
oxygen deliverability placement-test run | Create a placement test for one sending mailbox. | paid writes |
oxygen deliverability placement-test send | Preview or send the exact EmailGuard seed message for a provider-created test. | paid writes |
directory
| Command | What it does | Notes |
|---|---|---|
oxygen directory apply | Apply to be listed in the public agency directory (reviewed by the OXYGEN team). | writes |
oxygen directory get | Read-only, 0 credits. Read the listing, publish state, and public/settings deep-links. | |
oxygen directory publish | Publish at https://oxygen-agent.com/agencies. Requires a tagline, description, and at least one contact method (website, booking link, email, or LinkedIn). | writes |
oxygen directory unpublish | Remove the listing from the public directory (keeps the draft editable). | writes |
oxygen directory update | Update listing fields. Changes to a published listing are public immediately. Only invited organizations can edit. | writes |
domains
| Command | What it does | Notes |
|---|---|---|
oxygen domains add | BYOK CLOUDFLARE: onboard a domain registered elsewhere by creating a zone in your connected Cloudflare account. For managed domain + inbox provisioning use managed-inboxes subscribe. | writes |
oxygen domains adopt | STAFF LEGACY RECOVERY: attach domains that already exist in the shared Oxygen-managed Cloudflare account to their workspace. | writes staff |
oxygen domains archive | Hide a domain from the default list — an Oxygen-side declutter flag only. | writes |
oxygen domains buy | Buy sending domains. | paid writes |
oxygen domains check | Check availability and price for up to 20 exact domains. | |
oxygen domains delete | Delete domains and every inbox on them: cancels OXYGEN inbox orders; a domain bought through Oxygen on its own (domains buy) stops renewing and leaves the workspace, staying registered until… | writes |
oxygen domains dns | Run a live read-only DNS health check (SPF, DKIM, DMARC, MX) against the domain's Cloudflare zone and persist the result. | |
oxygen domains dns apply | Write the planned cold-email DNS records into the domain's Cloudflare zone. | paid writes |
oxygen domains dns plan | Preview the cold-email DNS records a domain should hold for its mailbox provider (SPF, per-provider DKIM, DMARC, MX, optional tracking) as a create/update/keep/conflict diff plus a plan_hash. | |
oxygen domains forwarding get | Show the domain's current web-root forwarding destination. Read-only, 0 credits. | |
oxygen domains forwarding set | Point the domain's web root at a URL. WITHOUT --approved this previews current -> new and writes nothing. Free (0 credits), but it changes what every visitor to the domain sees. | paid writes |
oxygen domains get | Get one domain's infrastructure/readiness detail: zone state, age with provenance, mailboxes, cached sending volume, and the last DNS health check. | |
oxygen domains list | List the org's cached Cloudflare domains with cold-email metadata (age, mailboxes, warmup, sending volume, DNS health). | |
oxygen domains registration-status | Get one domain registration's ledger state (the server performs a gated live poll when due — safe to call repeatedly). Pass --wait to poll until it settles. | |
oxygen domains registrations | List the org's domain purchase ledger: every registration attempt with status and price snapshot. | |
oxygen domains renewal | Turn the yearly renewal of a domain bought through Oxygen on or off. No charge. On: the registrar's renewal cost is charged in credits 30 days before expiry. Off: the domain lapses when it expires. | writes |
oxygen domains search | Search available domains with their price. | |
oxygen domains sync | Refresh Cloudflare-backed domains only: zone pages, registrar metadata, RDAP age backfill, and DNS health. | writes |
oxygen domains tag | Replace a domain's workspace tags (whole set; --tags "" clears) — e.g. pool the domains behind one campaign tag. | writes |
oxygen domains tracking setup | Provision the open/click tracking CNAME (<track-host> CNAME <tracking target>) on the domain's Cloudflare zone. | writes |
oxygen domains tracking status | Show the open/click tracking status for a domain (configured host, verification status, CNAME target, whether the tracking secret is set). Reads the cache — 0 Oxygen credits. | |
oxygen domains unarchive | Restore an archived domain to the default list. | writes |
egress
| Command | What it does | Notes |
|---|---|---|
oxygen egress assign | Converge mailbox policy assignments: managed/shared by default, or the workspace's dedicated IP for every current and future inbox once that add-on is active. | writes |
oxygen egress dedicated cancel | Cancel the dedicated sending-IP add-on. | writes |
oxygen egress dedicated request | Preview the dedicated native egress add-on (2,500 credits per 30-day period, $25 face value). | paid writes |
oxygen egress dedicated status | Show this org's dedicated sending-IP add-on state (status, quantity, activation, price). Read-only, 0 credits. | |
oxygen egress ips | List the shared native worker IP (it carries the sends, reply reads and token refreshes of every workspace without a dedicated IP) and this workspace's dedicated IP history. Read-only, 0 credits. | |
oxygen egress register | STAFF RECOVERY: register legacy/manual logical policy inventory for this environment. | writes staff |
oxygen egress rotate | RETIRED compatibility command. | writes deprecated |
oxygen egress status | Show this workspace's actual native egress mode, active IP, health counts, dedicated add-on, and one bounded page of the inspectable mailbox policy ledger. |
| Command | What it does | Notes |
|---|---|---|
oxygen email send | Send ONE email right now. Without --approved, returns a preview naming the exact mailbox + transport. --from pins a mailbox; otherwise the pool's LRU rotation picks one. | paid writes |
engagement
| Command | What it does | Notes |
|---|---|---|
oxygen engagement comment | Comment on a LinkedIn post (or reply to a comment with --comment-id). | paid writes |
oxygen engagement engagers | Read one post's reactors and commenters right now as a de-duplicated people list ready to enroll. | |
oxygen engagement harvest | Start (or re-arm) a harvest of a post's engagers into a workspace table you can enroll into a sequence. | paid writes |
oxygen engagement react | React to a LinkedIn post (or to a comment with --comment-id). | paid writes |
oxygen engagement status | Show an engagement harvest's progress (drip status, engagers ingested, last error) plus the workspace table it fills and a preview of harvested engagers. |
enrich-column
| Command | What it does | Notes |
|---|---|---|
oxygen enrich-column preview | Preflight an enrichment column without provider calls or credit usage. | |
oxygen enrich-column run | Create or reuse an enrichment column and queue a background run. | paid writes |
enrichment
| Command | What it does | Notes |
|---|---|---|
oxygen enrichment apply-default-cascade | Patch an existing enrichment column to the server-side default provider cascade for its intent. | writes |
oxygen enrichment catalog | Name the DATA, not the provider: list every data type you can ask a table to fill (person profile, work email, phone, headcount, funding, tech stack, hiring, competitors, news, decision makers… |
feedback
| Command | What it does | Notes |
|---|---|---|
oxygen feedback | Send feedback or a bug report to the OXYGEN team. |
feeds
| Command | What it does | Notes |
|---|---|---|
oxygen feeds bind | Bind a feed to a table: a scheduled provider harvest (pull), with --schema-json a typed-or-rejected push feed, or with --source rb2b the web-intent feed landing RB2B website-visit reveals as rows. | paid writes |
oxygen feeds deliveries | List the shared table delivery ledger: pull-feed sync cycles and inbound webhook deliveries land in the same place. | |
oxygen feeds get | Get one table feed: cadence and next run, per-cycle caps, cursor counters, last cycle, and last error. Read-only. | |
oxygen feeds list | List table feeds for the workspace, newest first. Read-only. | |
oxygen feeds pause | Pause a feed: the cron stays armed but every cycle it fires is refused, so nothing is fetched and nothing is billed until you resume. Free. | writes |
oxygen feeds resume | Resume a feed: re-activates it AND clears an error/exhausted stop, so the next cron tick can claim it again. Re-uses the cadence and spend cap already approved at bind time. Free. | writes |
oxygen feeds run | Run one sync cycle now through the feed's own cron workflow (one harvest path, one cursor). --mode dry_run (default) renders the exact next-cycle provider request with the cursor or watermark… | paid writes |
oxygen feeds unbind | Delete a feed: removes its cron FIRST, then the feed row. The table and every row it already wrote are kept. | writes |
find
| Command | What it does | Notes |
|---|---|---|
oxygen find company | Enrich a company via a waterfall: identity, firmographics, structured funding, competitors, corporate structure, acquisitions, news, job openings, tech stack, web-presence URLs. | paid |
oxygen find email | Find a person's work email via an input-aware multi-provider waterfall: a LinkedIn URL, name+domain, or first/last+domain each select the best provider profile, with an email-pattern pre-step and… | paid |
oxygen find linkedin | Resolve a person's LinkedIn URL from name + company (or email), with identity validation. | paid |
oxygen find person | Enrich one person from a LinkedIn URL, a LinkedIn public id, a Sales Navigator link, or an email / name + company: one managed profile lookup returns the profile block — first, last and full name… | paid |
oxygen find personal-email | Find a person's personal (non-work) email — for ad-audience uploads, recruiting, or founder outreach — via a cost-ordered multi-provider waterfall that bills only on a hit and grades the address… | paid |
oxygen find phone | Find a person's mobile phone via a multi-provider waterfall. | paid |
followers
| Command | What it does | Notes |
|---|---|---|
oxygen followers import | Start (or re-arm) a followers import. | writes |
oxygen followers status | Show followers-import progress (per-sender drip status, followers ingested, last error) plus a preview of the followers table and a deep-link to open it. |
formulas
| Command | What it does | Notes |
|---|---|---|
oxygen formulas functions | List every formula function (name, signature, examples), the operator grammar, and the expression_notes that a signature cannot teach (bare column keys, string escapes, no regex flags, read-time… | |
oxygen formulas validate | Validate a formula against a table and preview its output on sample rows — free, no writes. Draft → validate → attach with oxygen columns add --kind formula. |
functions
| Command | What it does | Notes |
|---|---|---|
oxygen functions bind | Add a Function column with explicit input/output mappings and a caller credit cap. | writes |
oxygen functions delete | Preview removal from the Function library, then remove it with --yes; preserves backing tables, rows and run history. | writes |
oxygen functions describe | Inspect a Function's inputs, outputs, steps, per-row credit estimate, caps, and draft or published version. | |
oxygen functions disable | Disable future Function invocations; captured runs are unchanged. | writes |
oxygen functions draft | Create a Function draft, or save an existing Function's draft; executes nothing. | writes |
oxygen functions duplicate | Copy a Function's steps into a new editable draft (same inputs and outputs, no rows). | writes |
oxygen functions enable | Enable future Function invocations; captured runs are unchanged. | writes |
oxygen functions favorite | Favourite a Function so it appears under functions list --favorites and the Favorites tab; per user, per workspace. | |
oxygen functions list | List your workspace's drafts and published Functions with per-row credit estimates (up to 500). | |
oxygen functions publish | Publish the inspected draft for every caller's future invocations; preserves captured runs and caller caps. | writes |
oxygen functions rename | Rename a Function while preserving its identity, callers and published execution. | writes |
oxygen functions restore | Retired: OXYGEN-provided Functions can no longer be restored. Create a workspace Function instead. | writes deprecated |
oxygen functions runs | Inspect a Function's latest 100 invocations, the table that called each one, and their captured versions. | |
oxygen functions unfavorite | Remove a Function from your favourites. |
home
| Command | What it does | Notes |
|---|---|---|
oxygen home | Your workspace standup: what happened since you last looked, what needs you, and a year of workspace activity. |
inbox
| Command | What it does | Notes |
|---|---|---|
oxygen inbox analyze | Run analysis on a conversation now: status + a drafted reply (Oxygen's default model). The worker also does this automatically on inbound conversations. | |
oxygen inbox archive | Archive a conversation (triage it out of the inbox). --unarchive restores it. --channel linkedin/whatsapp archives a DM. | writes |
oxygen inbox auto-tagger get | Show the auto-tagger config (enabled, tag allowlist, channels). | |
oxygen inbox auto-tagger set | Update the auto-tagger. --tags replaces the whole allowlist (max 50; --tags "" clears, which pauses tagging while keeping the agent enabled). | writes |
oxygen inbox backfill | Opt-in, LinkedIn only: pull a LinkedIn account's OLDER message history into the unibox. | writes |
oxygen inbox bulk | Bulk-apply one triage action — set-status / archive / unarchive — across up to 100 hand-picked conversations (the ids inbox list returns) in one call. | |
oxygen inbox delete-message | Delete your sent LinkedIn message for everyone within 60 minutes. This cannot be undone. Omit --approved for a preview; show it before approving. Other channels and inbound messages are unsupported. | writes |
oxygen inbox drafts edit | Edit an open draft's body before approval. Does not send. | writes |
oxygen inbox drafts list | List drafts awaiting review (queued + edited by default), across email + LinkedIn. | |
oxygen inbox drafts reject | Reject an open draft so it leaves the queue. Does not send. | writes |
oxygen inbox get | Get one conversation with its full message thread. <conversation> accepts a conversation id, Unipile chat id, or (email) Zapbox thread id, and is resolved on any channel by default (email first… | |
oxygen inbox labels create | Create a custom status label. | writes |
oxygen inbox labels delete | Archive a custom status label (system labels and in-use labels are rejected). | writes |
oxygen inbox labels list | List status labels. | |
oxygen inbox labels restore | Restore an archived custom status label under its original key. | writes |
oxygen inbox labels update | Update a status label's name, color, bucket, description, or (custom labels only) ai-settable flag. | writes |
oxygen inbox list | List conversations newest first across email, LinkedIn, and WhatsApp — the merged stream is the default, --channels narrows it, and --channel email/linkedin/whatsapp lists a single channel. | |
oxygen inbox mark-all-read | Mark EVERY conversation matching the filters as read — the whole filtered set across email + LinkedIn + WhatsApp, not just the conversations on the page you can see. | writes |
oxygen inbox mark-read | Mark a conversation and all its messages as read. | writes |
oxygen inbox reply-agent get | Show the reply-agent config. | |
oxygen inbox reply-agent set | Configure the reply agent (enable, persona/tone, targets). | writes |
oxygen inbox rescan | Re-queue conversations for AI re-classification (status + drafted reply). | writes |
oxygen inbox send | Reply into a conversation on its own channel, resolved from the conversation when --channel is omitted: an email thread replies from its own mailbox (Zapbox/native Gmail/Graph, threaded); a… | paid writes |
oxygen inbox start-whatsapp | Start a one-to-one WhatsApp chat from the Unibox. | paid writes |
oxygen inbox status | Set a conversation's status (the Instantly-style tier). A manual override that locks out AI re-classification. --channel linkedin/whatsapp sets a DM's status. | |
oxygen inbox sync | Force a backstop inbox sync from Unipile for the active LinkedIn and WhatsApp sender accounts (pulls recent chats + messages into the unibox). | writes |
oxygen inbox tag | Add/remove workspace tags on a conversation (Tags primitive — the same vocabulary as sequences, tables, posts; see oxygen tags list). | writes |
integrations
| Command | What it does | Notes |
|---|---|---|
oxygen integrations actions | List actions available for a connected integration — Composio toolkits and native providers (e.g. Instantly) alike. | |
oxygen integrations connect | Connect an integration. | writes |
oxygen integrations destinations | List where a connected integration can send — for Microsoft Teams, your teams and your chats, plus one team's channels with --team-id. | |
oxygen integrations disconnect | Disconnect an integration. LinkedIn and WhatsApp remove the Unipile connected account; pass --connection-id when more than one is connected. | writes |
oxygen integrations events deliveries | List recent provider webhook deliveries (Composio triggers, HubSpot webhooks, etc.) and the workflow runs they kicked off. | |
oxygen integrations events disable | Disable a provider event for a connected integration account. | writes |
oxygen integrations events enable | Enable a provider event for a connected integration account. | writes |
oxygen integrations events list | List raw provider event definitions and this org's enabled subscriptions. To choose a workflow trigger, use oxygen workflows events list. | |
oxygen integrations github branches | ||
oxygen integrations github repositories | ||
oxygen integrations list | List supported integrations and this org's connections. | |
oxygen integrations run | Run an action for a connected integration — Composio toolkits and native providers alike. | paid writes |
oxygen integrations test | Re-validate a stored integration API key against the provider and heal the connection when it passes (recovers benched or scope-degraded connections without re-pasting the key). |
knowledge
| Command | What it does | Notes |
|---|---|---|
oxygen knowledge agent get | Show the synthesis-agent config (enabled, cadence, per-day credit cap). | |
oxygen knowledge agent set | Configure the synthesis agent. Enabling lets the background worker distill new sources on the cadence; it only writes working learnings pages. | paid writes |
oxygen knowledge bootstrap | Research this workspace's company through direct LinkedIn company enrichment and website reads. | paid writes |
oxygen knowledge bootstrap status | Report the once-ever bootstrap marker for this workspace: status (queued, running, completed, partial, skipped, failed, or never attempted), when it ran, its system run id, the credits it actually… | |
oxygen knowledge files archive | Archive a file with revision checking. A connected two-way repository publishes the deletion; history remains. | writes |
oxygen knowledge files download | Download exact original bytes with digest verification; refuses to overwrite an existing local file. | |
oxygen knowledge files get | Read original file content, properties and download link at an optional immutable revision. | |
oxygen knowledge files list | ||
oxygen knowledge files upsert | Create or replace an original file, or update frontmatter properties. Canonical copy still requires a proposal. | writes |
oxygen knowledge folders create | Create a persistent knowledge folder, optionally inside another folder. | writes |
oxygen knowledge folders list | List workspace folders and page locations, including empty folders. Read-only, 0 credits. | |
oxygen knowledge folders move | Move a folder and its contents to another folder or the workspace root. | writes |
oxygen knowledge graph | Knowledge graph of pages and their [[wikilink]] edges. Pass --center to render one page's local neighborhood instead of the whole graph. Read-only, 0 credits. | |
oxygen knowledge index | Compact wiki index: each page's slug, one-liner, tags, link degree, plus type/status counts over the whole wiki. | |
oxygen knowledge lint | Read-only structural wiki health report, 0 credits: orphans (unfilled seed stubs excluded), dead-ends, unresolved links, contradictions (disputed pages, conflicting trust tags, competing live-copy… | |
oxygen knowledge lint relink | Recompute [[wikilink]] edges (and gap-fill unlinked mentions) across wiki pages. | writes |
oxygen knowledge log append | Append an entry to the knowledge log. | |
oxygen knowledge log list | List knowledge log entries, newest first. Read-only, 0 credits. | |
oxygen knowledge page archive | Archive a knowledge wiki page. | writes |
oxygen knowledge page get | Read one knowledge wiki page by slug or UUID. Read-only, 0 credits. | |
oxygen knowledge page list | List knowledge wiki pages. Read-only, 0 credits. | |
oxygen knowledge page pin | Pin a knowledge wiki page as the canonical default for its type. Canonical voice/brand/positioning pages are auto-applied to AI copy generation. | paid writes |
oxygen knowledge page revision | Read one full revision snapshot of a knowledge wiki page. Read-only, 0 credits. | |
oxygen knowledge page revisions | List the revision history of a knowledge wiki page, newest first. Read-only, 0 credits. | |
oxygen knowledge page upsert | Create or update a knowledge wiki page. | paid writes |
oxygen knowledge profile | Company profile and ICP memory. | |
oxygen knowledge profile update | Merge one or more profile sections into workspace GTM memory. | writes |
oxygen knowledge proposals | Draft change proposals against wiki pages, awaiting human review. Read-only, 0 credits. | |
oxygen knowledge proposals approve | Approve a knowledge proposal and apply it to the target page. | writes |
oxygen knowledge proposals reject | Reject a knowledge proposal without changing the target page. | writes |
oxygen knowledge purge | Delete the whole local knowledge mirror for the active API host and organization. | writes |
oxygen knowledge push | Push locally edited or newly created mirror pages back to the workspace wiki. Edits to canonical voice/brand/positioning pages become approval proposals instead of writing live. | writes |
oxygen knowledge repositories conflicts | Read conflicts; add --path to inspect preserved base, Oxygen, and GitHub versions. | |
oxygen knowledge repositories connect | Approve the exact preview and start importing. two_way authorizes future automatic GitHub writes to the selected branch. 0 Oxygen credits. | writes |
oxygen knowledge repositories disconnect | Disconnect this repository; keep its files and history in Knowledge. | writes |
oxygen knowledge repositories list | Read connected repositories, import progress, sync freshness, pending changes, and errors. 0 credits. | |
oxygen knowledge repositories pause | Pause automatic sync; keep all imported files and history. | writes |
oxygen knowledge repositories preview | Preview branch/folder contents, exclusions and the future sync policy. Does not activate sync. 0 credits. | |
oxygen knowledge repositories resolve | Apply a reviewed conflict decision. Canonical copy remains proposal-gated; GitHub publishes under the saved sync policy. | writes |
oxygen knowledge repositories resume | Resume the previously approved sync policy. | writes |
oxygen knowledge repositories sync | Request an immediate sync attempt. Saved changes remain safe if GitHub is unavailable. | writes |
oxygen knowledge resolve | Resolve task-scoped workspace GTM context with readiness and revision provenance. | writes |
oxygen knowledge search | Search wiki pages by meaning and keywords. | |
oxygen knowledge seed | Seed or upgrade the knowledge wiki scaffold: on first run creates the starter page set — a start-here guide, a conventions schema page, and 19 draft stub hubs (icp, positioning, offers… | writes |
oxygen knowledge status | Report the local knowledge mirror: path, page count, last sync, quarantined conflicts. Pass --all to report every locally mirrored workspace for the active API host. | |
oxygen knowledge sync | Clone or refresh the local knowledge mirror: server-rendered page markdown under the CLI config dir. Pass --all to mirror every workspace the credential can access. | writes |
oxygen knowledge synthesize | Synthesize knowledge from workspace evidence (one low-cost AI call): campaign learnings from auto-filed outreach outcomes, or a voice guide from sent messages. | paid writes |
lead-sourcing
| Command | What it does | Notes |
|---|---|---|
oxygen lead-sourcing audit | Audit a sourced lead table against a lead-sourcing spec. | |
oxygen lead-sourcing plan | Compile a natural-language ICP into an account-first lead sourcing plan. |
limits
| Command | What it does | Notes |
|---|---|---|
oxygen limits provider delete | Remove a per-provider override (falls back to the plan-tier default). | writes |
oxygen limits provider list | List enforced provider overrides and the plan-tier BYOK daily threshold with its enforcement mode. | |
oxygen limits provider set | Set an enforced per-provider call ceiling. Use --window-seconds 86400 for an explicit daily policy. | writes |
oxygen limits show | Compare every plan size: price, monthly credits, volume bonus and price per 100 credits (plan_bands). |
| Command | What it does | Notes |
|---|---|---|
oxygen linkedin connections invite | Send a LinkedIn connection invitation. | paid writes |
oxygen linkedin ingestion status | Unified status of every LinkedIn ingestion drip (connections import, engagement harvest, message-history backfill) plus each account's remaining ingest read budget for the day. | |
oxygen linkedin intent autoenroll | Authorize the captures armed by linkedin intent setup to enroll the people they capture into a sequence — the step that turns captured rows into outreach. | paid writes |
oxygen linkedin intent setup | Create/reuse the canonical OXYGEN Tables, link them, and arm capture-only worker-backed engagement workflows for profile viewers, followers, and connections. | writes |
oxygen linkedin intent status | Show the canonical intent tables, their linked-table deep-links, and the capture feeds filling them. | |
oxygen linkedin invitations list | List the account's pending sent LinkedIn invitations with their invitation ids — the ids linkedin invitations withdraw --ids cancels. | |
oxygen linkedin invitations pause | Stop checking open connection requests for one account (--account) or every account. The table and its rows stay; linkedin invitations setup switches it back on. Free. | writes |
oxygen linkedin invitations setup | Switch on the open connection requests table. | writes |
oxygen linkedin invitations status | Show the open connection requests table: accounts[] lists every connected LinkedIn account with on, its state (off|collecting|waiting|paused|attention), and when it was last and will next be… | |
oxygen linkedin invitations withdraw | Withdraw pending sent LinkedIn invitations. | paid writes |
oxygen linkedin network pause | Switch network capture off: the worker stops reading that account's connections and followers until you run linkedin network setup again. | writes |
oxygen linkedin network setup | Arm (or re-arm) network capture. | writes |
oxygen linkedin network status | Show network capture progress: accounts[] lists every connected LinkedIn account with its headline, on (switched on or not), and state (off|collecting|waiting|paused|attention); which accounts… |
login
| Command | What it does | Notes |
|---|---|---|
oxygen login | Connect this terminal to Oxygen. Opens the browser to approve this terminal (matching confirmation code shown in both); paste a token with --token instead if you prefer. | writes |
logout
| Command | What it does | Notes |
|---|---|---|
oxygen logout | Remove the active stored CLI API token. | writes |
mailboxes
| Command | What it does | Notes |
|---|---|---|
oxygen mailboxes cap set | Set one sending mailbox's daily send cap (sends per day; new mailboxes get 25). --daily-cap must be a positive whole number; oxygen limits show reports the maximum in force. | writes |
oxygen mailboxes compatibility | Read-only compatibility report per mailbox — select with --mailboxes <address,…> (omit for the whole pool; filter here, not in a script): generic origin class, real infrastructure tier (including… | |
oxygen mailboxes connect-oauth | Connect Google/Microsoft mailboxes to OXYGEN native send. | paid writes |
oxygen mailboxes delegation | Google sending-domain delegation only — not Microsoft OAuth and not a credential-file handoff to OXYGEN Warm-up or EmailGuard. | |
oxygen mailboxes delete | Preview or approve removal of exact mailboxes from Oxygen at 0 credits. | writes |
oxygen mailboxes emailguard auto-enroll | Standing permission to connect NEW eligible mailboxes to EmailGuard automatically, so monitoring keeps up with the fleet instead of needing a manual connect per inbox. | paid writes |
oxygen mailboxes emailguard connect | Preview or connect selected mailboxes to EmailGuard. | paid writes |
oxygen mailboxes emailguard disconnect | Preview or remove selected mailboxes from EmailGuard and cancel their recurring monitoring subscription. Remote absence is confirmed before billing stops. | paid writes |
oxygen mailboxes get | Get one sending mailbox's configuration/readiness detail (provider, status, daily cap, warmup state, auth mode, and source — managed vs bring-your-own) plus a one-row pool summary. | |
oxygen mailboxes health | Fleet email-health: the sending pool rolled up by external deliverability reputation (healthy/degraded/critical/unknown), per-mailbox scores, connected health providers, and DIRECTIONAL… | |
oxygen mailboxes import | Register (or refresh) sending mailboxes in bulk. | writes |
oxygen mailboxes list | List the org's sending mailboxes with provider, status, warmup state, source (managed = bought through Oxygen, byok = bring-your-own), worker-owned connectionRepair and warmupRepair state, and a… | |
oxygen mailboxes oauth-health | Show every Google/Microsoft inbox with neither a usable per-mailbox OAuth token nor verified delegation/application access. automatic_repair marks Zapmail-linked rows whose safe retries OXYGEN… | |
oxygen mailboxes order | RETIRED — managed mailboxes are now purchased as monthly subscriptions via oxygen managed-inboxes subscribe (InboxKit-backed). | writes deprecated |
oxygen mailboxes ramp set | Set one mailbox's campaign sending-day ramp: --start-per-day (initial ceiling), --increase-every-days (completed UTC days with accepted campaign sends), --step, --cap. | writes |
oxygen mailboxes status | Set a sending mailbox's status. Pausing/disabling takes the inbox out of the rotation pool without losing its warmup state. | |
oxygen mailboxes tag | Replace a sending mailbox's workspace tags (whole set; --tags "" clears) — e.g. pool the mailboxes behind one campaign tag. See oxygen tags list for the vocabulary. | writes |
oxygen mailboxes update | Update a sending mailbox's rich-content profile: the From display name and/or the HTML signature appended to its sends. | writes |
oxygen mailboxes warmup config | Read or override optional provider warm-up traffic, separate from the campaign ramp. | |
oxygen mailboxes warmup disable | Disable warmup and unenroll each mailbox from the rail that actually enrolled it. | writes |
oxygen mailboxes warmup enable | Optional provider warm-up defaults to 1/day, +1/day, max 10/day (dedicated-tenant profiles stay stricter); see mailboxes warmup config for the effective plan and unsupported OXYGEN Warm-up… | paid writes |
oxygen mailboxes warmup microsoft | NON-INBOXKIT FALLBACK ONLY: authorize eligible Microsoft/Outlook mailboxes for OXYGEN Warm-up with ONE browser consent PER MAILBOX, never a password or app password. | paid |
oxygen mailboxes warmup pause | Pause warmup at the rail that actually enrolled each mailbox — OXYGEN Warm-up for current enrollments, TrulyInbox for inboxes still warming there. | writes |
oxygen mailboxes warmup profile | Pin the SENDING ARCHITECTURE a domain is run as, which every inbox on it inherits: standard (a few mailboxes on a real business tenant, each climbing to a real number), dedicated_tenant… | paid |
oxygen mailboxes warmup reactivate | Manual reactivation of an existing live paid seat: ask the warm-up provider to re-run the connection check on an inbox it has DISABLED, without touching the credential, subscription, or ramp day. | writes |
oxygen mailboxes warmup reconnect | Manual repair for an existing live paid seat when worker recovery is shadow/off, exhausted, or needs a new credential: push the mailbox's CURRENT credential to its warmup provider. | writes |
oxygen mailboxes warmup resume | Resume paused warmup at each mailbox's recorded rail (OXYGEN Warm-up, or TrulyInbox for inboxes still warming there). 0 Oxygen credits; the existing subscription is unchanged. | writes |
oxygen mailboxes warmup status | Read warmup analytics back from the rail each mailbox is enrolled on and refresh each mailbox's warmupTruth (state, last send, pause reason, dispatch counters, next_action). | writes |
managed-inboxes
| Command | What it does | Notes |
|---|---|---|
oxygen managed-inboxes add-inboxes | Add mailboxes to a managed domain you ALREADY own — no new domain is registered and there is NO domain registration charge, only the extra inboxes' monthly rate (plus their add-ons). | paid writes |
oxygen managed-inboxes cancel | Cancel a managed inbox order by domain: the inboxes AND every recurring add-on on them (warm-up, inbox placement). | paid writes |
oxygen managed-inboxes exit | Transfer ONE managed domain out of OXYGEN: stop every OXYGEN renewal for this domain after the paid period; keep the domain, mailboxes, DNS, warm-up state and data exactly as they are. | paid |
oxygen managed-inboxes get | Get one managed inbox subscription by domain (vendor, platform, mailbox count, monthly USD price, vendor order id, lifecycle status, auto-renew, period end, internal billing status). | |
oxygen managed-inboxes list | List the org's managed inbox orders: vendor, platform, live inbox count, lifecycle status, internal billing posture, and each order's FULL monthly cost — the inbox line, each inbox's mailbox… | |
oxygen managed-inboxes registrant | Show the registrant (WHOIS) contact this workspace files domain registrations under, or null if it has never bought one. | |
oxygen managed-inboxes subscribe | Subscribe a NEW domain + mailboxes as a managed monthly inbox subscription. | paid writes |
oxygen managed-inboxes upload-avatar | Host a one-off mailbox profile picture and print the URL to pass as profile_picture_url in --mailboxes JSON. | writes |
oxygen managed-inboxes verify | Check that OXYGEN, STRIPE, and the VENDOR agree about what this org is buying. |
messages
| Command | What it does | Notes |
|---|---|---|
oxygen messages query | Query messages across channels newest first, or relevance-ranked when -q is set. --channel all merges email + LinkedIn + WhatsApp (narrow with --channels); a campaign filter (--sequence-id)… | |
oxygen messages stats | INBOX-WIDE message-ledger analytics over the WHOLE corpus, not your campaigns: outbound/inbound totals, a conversation-level reply rate (has-inbound over has-outbound) by channel, status… |
notetaker
| Command | What it does | Notes |
|---|---|---|
oxygen notetaker schedule | Schedule an invited meeting bot. Defaults to dry-run. | paid writes |
oxygen notetaker setup | Configure the Recall-backed Oxygen Notetaker. Defaults to dry-run. | writes |
oxygen notetaker status | Get one notetaker session with artifacts and credit state. |
observability
| Command | What it does | Notes |
|---|---|---|
oxygen observability approvals | List everything waiting for a human decision across workflows, publishing, message reviews, inbox reply drafts, and collaboration approval requests — the cross-primitive approvals inbox. | |
oxygen observability events | List recent redacted OXYGEN operation events and failures. Customer support triage and support-event history live in Plain Inbox. | |
oxygen observability runs | List active and failed runs across workflows and table action/ingestion runs — the cross-primitive runs lens. Read-only; each failed item carries the command that resolves it. |
orgs
| Command | What it does | Notes |
|---|---|---|
oxygen orgs billing-link | Cover a workspace with a plan you already pay for in another organization (one plan, many workspaces) instead of buying a second subscription. | writes |
oxygen orgs billing-owners | List the organizations that could pay for this workspace: which of the organizations you belong to can cover another workspace's credits, and for each of the rest, why it cannot. | |
oxygen orgs billing-unlink | Return a workspace to owning its own billing: it stops being covered by another organization's plan and needs a subscription of its own again. | writes |
oxygen orgs list | List organizations available to the current CLI identity. | |
oxygen orgs member-role | Move a member between the admin and member workspace roles. | |
oxygen orgs select | Alias for orgs use. | writes alias |
oxygen orgs use | Select the active organization for this CLI profile. | writes |
people
| Command | What it does | Notes |
|---|---|---|
oxygen people search filters | List Find people filter fields and options without a provider call: people.* (title, level, function, location, education) and company.* (industry, headcount, location, funding, up to 50 company… | |
oxygen people search plan | Compile a people-search prompt and optional typed persona filters into ordered provider routes without provider calls. | |
oxygen people search preview | Preview up to 50 people free, using native filters from people search filters. | |
oxygen people search run | Return a dry-run request or queue a live people-search ingestion run. Upsert dedup is on linkedin_url. | paid writes |
posts
| Command | What it does | Notes |
|---|---|---|
oxygen posts comments | Read one post's comments live from LinkedIn (or one comment's replies with --comment-id). | |
oxygen posts create | Publish a LinkedIn post from the connected account. | paid writes |
oxygen posts delete | Delete a LinkedIn post the connected account authored — a REAL, irreversible public write. | paid writes |
oxygen posts get | LIVE provider read of one LinkedIn post. | |
oxygen posts reactions | List a post's reactions (or a comment's reactions with --comment-id). --post MUST be the composite social_id from posts get. Metered as an account read. |
profiles
| Command | What it does | Notes |
|---|---|---|
oxygen profiles current | Show the profile the next command will use, and where it came from. | |
oxygen profiles env | Print shell export lines that pin this terminal to a stored CLI profile. | |
oxygen profiles list | List stored CLI credential profiles. | |
oxygen profiles remove | Remove one stored CLI credential profile. | writes |
oxygen profiles use | Switch the active CLI credential profile. | writes |
projects
| Command | What it does | Notes |
|---|---|---|
oxygen projects color | Set a project's colour in the Tables rail. --color auto restores the automatic colour. | writes |
oxygen projects create | Create a schema-backed table project (folder). Free. Group tables into it with oxygen tables move <tables...> --project <folder>. | writes |
oxygen projects delete | Delete a non-General folder and its tables. | writes |
oxygen projects list | List table projects (folders) with each one's active table count (tableCount), so empty and oversized folders show without listing every folder's tables. Free. | |
oxygen projects rename | Rename a table project's display name and slug without changing its tables. | writes |
oxygen projects tag | Replace a project's workspace tags (whole set; --tags "" clears). See oxygen tags list for the vocabulary. | writes |
prompts
| Command | What it does | Notes |
|---|---|---|
oxygen prompts archive | Archive a prompt template. Seeded templates cannot be archived. | writes |
oxygen prompts get | Read one prompt template by id or slug. | |
oxygen prompts list | List prompt templates in the workspace. | |
oxygen prompts upsert | Create or update a prompt template. | writes |
publishing
| Command | What it does | Notes |
|---|---|---|
oxygen publishing amplification actions | The policy's action ledger: what each participant account did (or is about to do) on which post, with status and cost. | |
oxygen publishing amplification create | Create an amplification policy. | paid writes |
oxygen publishing amplification delete | Delete a policy. | writes |
oxygen publishing amplification disable | Disarm a policy and skip every action it had already planned. Always allowed — the off switch is never gated. | writes |
oxygen publishing amplification enable | Arm a policy. | paid writes |
oxygen publishing amplification get | Get one policy: scope, participants, caps, pacing, enabled state, and standing approval. | |
oxygen publishing amplification list | List amplification policies with their scope, caps, and enabled state. | |
oxygen publishing amplification update | Update a policy's participants, actions, caps, or pacing. Tightening a cap takes effect on the next cycle. | paid writes |
oxygen publishing analytics account | Stored per-account metric series (followers) for connected LinkedIn and X publishing accounts, read once a day in the background. Read-only: no provider call, 0 credits. | |
oxygen publishing analytics emv | Set the workspace CPM used for earned-media value, per channel. EMV stays null on any channel whose provider does not expose impressions. | |
oxygen publishing analytics post | One post's stored daily metric series, totals, growth curve, 24h/7d benchmarks against the workspace median, and earned-media value. | |
oxygen publishing analytics summary | Workspace LinkedIn or X analytics. | |
oxygen publishing analytics timeseries | Impressions and engagements EARNED per day across all tracked posts (not only posts published in the range), with reactions, comments and reposts also reported on their own, whether each is… | |
oxygen publishing comments approve | Post one exact previewed reply publicly. A REAL LinkedIn write; refused without --approved and the preview's content hash. | paid writes |
oxygen publishing comments get | Get one stored public comment with its provider thread and immutable reply-action history. Read-only: no provider call, 0 credits. | |
oxygen publishing comments list | List the Publishing Community work queue, oldest first, with polling freshness/backoff even when empty. | |
oxygen publishing comments reply | Preview an exact public reply and return its action_id + content_hash. Makes no provider call, posts nothing, and uses 0 credits. | writes |
oxygen publishing comments resolve | Resolve, ignore, mark spam, or reopen one local public-comment work item. No provider write, 0 credits. | writes |
oxygen publishing comments update | Save local draft, notes, assignment, or triage state. Nothing is posted publicly and no credits are used. | writes |
oxygen publishing drafts accept | Accept a draft variant into the publish queue. The post is created needs-approval — approve it separately before it can publish. | writes |
oxygen publishing drafts edit | Rewrite one variant's text. The first edit snapshots the AI's original copy, so accepting it teaches the Knowledge Graph what you changed. | writes |
oxygen publishing drafts list | List post drafts. Defaults to the open queue (queued + edited). | |
oxygen publishing drafts reject | Reject a draft. The reason is filed to the Knowledge Graph so the next drafts learn from it. | writes |
oxygen publishing ideas add | File an idea into the backlog. Free — no AI call, nothing scheduled. Turn one into a post later with publishing drafts accept --publish-at. | writes |
oxygen publishing ideas list | List the idea backlog. | |
oxygen publishing import | Bulk-load scheduled posts from a .csv or .json file. | paid writes |
oxygen publishing media upload | Upload a local image, video, or PDF in one step and print its media id. | writes |
oxygen publishing media upload-url | Create a Publishing media asset and presigned upload URL with required upload headers. | writes |
oxygen publishing media uploaded | Verify an uploaded Publishing media object and mark the media asset uploaded. | |
oxygen publishing mentions resolve | Resolve @handles, LinkedIn profile/company links, provider ids, and URNs — through a connected sender (notify=false, free) or the managed scraper (--source scraper, paid, no sender/window needed). | paid writes |
oxygen publishing posts approve | Approve a scheduled post so the worker can publish it when due. LinkedIn approval resolves every inline @<public-identifier> and blocks with inspectable details if any mention cannot be verified. | writes |
oxygen publishing posts boost | Boost ONE post: your teammates' connected accounts react to and comment on it, once. | paid |
oxygen publishing posts cancel | Cancel a draft, scheduled, queued, or failed post. | writes |
oxygen publishing posts create | Create a personal Publishing post. Use --ugc-participation-id to save it into one program as an unapproved draft; otherwise it defaults to scheduled and publishes only after approval. | paid writes |
oxygen publishing posts delete | Permanently delete the OXYGEN copy and its settled history, keeping the live platform post intact. | writes |
oxygen publishing posts draft | Draft posts with AI, grounded in the workspace Knowledge Graph. | paid writes |
oxygen publishing posts get | Get one scheduled post with resolved media previews, its LinkedIn video cover, and attempt history. | |
oxygen publishing posts list | List scheduled posts by publish time, oldest first; pass --order newest for the latest first. Follow next_cursor for more than one page. | |
oxygen publishing posts note | Leave an internal review note on a post, or reply to one with --parent. Never published. | writes |
oxygen publishing posts notes | List the internal review notes on a post. Notes are workspace-only — they are never published. | |
oxygen publishing posts resolve-note | Mark a review note handled. | writes |
oxygen publishing posts restore | Roll a post's TEXT back to an earlier revision (see publishing posts revisions). | writes |
oxygen publishing posts retry | Move a failed post back to scheduled for another worker attempt. A post that failed with publishing_effect_outcome_uncertain stays locked until you check the account and pass --confirm-not-published. | writes |
oxygen publishing posts review | Pre-publish review of a post: deterministic channel lint (free, and blocking at approve) plus an AI voice/claims check against the Knowledge Graph. | paid |
oxygen publishing posts revisions | List a post's content history: every revision with its number, title, text, author, and time. | |
oxygen publishing posts uncancel | Reopen a canceled post as an unapproved draft, keeping its publish time and its attempt history. | |
oxygen publishing posts update | Update an editable draft, scheduled, or failed post. | writes |
oxygen publishing tags set | Add and/or remove workspace tags on a post. | writes |
recipes
| Command | What it does | Notes |
|---|---|---|
oxygen recipes apply | Install a recipe's kit: every Blueprint stage in order under ONE approval — 0 credits, no provider calls, no external writes, every installed Workflow disabled until you arm it with its own credit… | writes |
oxygen recipes install | Install a recipe into the workspace wiki as a playbook page (revisioned, retrieval-grounded, with per-version provenance). | |
oxygen recipes list | List recipes, optionally filtered by text, business-case category, journey stage, or audience. | |
oxygen recipes show | Show one recipe: its kit, the install status of each stage here, prerequisites, credits, approval gates, and the playbook body. Alias: get. |
reviews
| Command | What it does | Notes |
|---|---|---|
oxygen reviews accept | Accept a pending message review. | writes |
oxygen reviews list | List message reviews. | |
oxygen reviews next | Read the oldest pending review. | |
oxygen reviews reject | Reject a pending message review with optional highlights and auto-rerun. | writes |
rows
| Command | What it does | Notes |
|---|---|---|
oxygen rows history | Show row change history. | writes |
runs
| Command | What it does | Notes |
|---|---|---|
oxygen runs get | Get one run with events. | |
oxygen runs list | List recent tenant runs. |
search
| Command | What it does | Notes |
|---|---|---|
oxygen search plan | Plan an Oxygen search or scrape route before running provider jobs. | |
oxygen search run | Preview or enqueue a durable table-backed search/scrape job from a search plan. | paid writes |
oxygen search runs cancel | Request cancellation for a queued or running search/scrape run. | writes |
oxygen search runs get | Get one durable search/scrape run. | |
oxygen search runs items | List search/scrape run items. | |
oxygen search runs retry-failed | Requeue failed search/scrape run items. | writes |
oxygen search runs wait | Poll a durable search/scrape run until it finishes. |
senders
| Command | What it does | Notes |
|---|---|---|
oxygen senders checkpoint resend | Ask LinkedIn to resend the checkpoint code so you can read a fresh one, then submit it with senders checkpoint solve. <id> accepts a sender account id, connection id, or Unipile account id. | writes |
oxygen senders checkpoint solve | Submit the LinkedIn checkpoint code Unipile is waiting on to finish authentication. <id> accepts a sender account id, connection id, or Unipile account id; <code> is the verification code LinkedIn… | writes |
oxygen senders checkpoints | List LinkedIn senders stuck on a security checkpoint (2FA / OTP / in-app validation), each with status, warm-up day, today's usage vs. caps, and the latest error — plus a fleet tally of every… | |
oxygen senders connect | Get a Unipile hosted-auth URL to connect a new LinkedIn account (or reconnect with --reconnect). | writes |
oxygen senders disconnect | Disconnect a LinkedIn sender account so it stops sending and frees its sending seat for another account. | writes |
oxygen senders get | Get one LinkedIn sender account with status, limits, daily-reset timezone, and usage. <id> accepts a sender account id, connection id, or Unipile account id. | |
oxygen senders health | Show a one-call health snapshot for a LinkedIn sender: status, the latest error reason, any open security checkpoint, today's usage, the warm-up ramp, and when the daily quota resets. | |
oxygen senders inbox-scope get | Show whether a sender syncs only OXYGEN-started conversations or its entire LinkedIn inbox. | |
oxygen senders inbox-scope set | Set LinkedIn inbox privacy. oxygen_initiated hides and stops ingesting unrelated chats; all opts into the full inbox. | writes |
oxygen senders inmail-balance | Show remaining LinkedIn InMail credits for a sender (Premium / Sales Navigator / Recruiter each hold a separate pool). | |
oxygen senders limits get | Show current limits, overrides, working hours (timezone, days, start, end), defaults, and safe maximums for an account. <id> accepts a sender account id, connection id, or Unipile account id. | |
oxygen senders limits set | Adjust per-account action limits and working hours. | writes |
oxygen senders list | List connected LinkedIn sender accounts with health status, rate limits, and today's usage. Disconnected accounts are hidden unless you pass --status disconnected. | |
oxygen senders profiles attach | Attach senders and/or inboxes to a profile. | writes |
oxygen senders profiles create | Create a sender profile: one person's sending identity — their LinkedIn/WhatsApp senders and email inboxes under one name and photo. --from-linkedin seeds the name + avatar from a LinkedIn account… | writes |
oxygen senders profiles delete | Delete a sender profile. Refused while the profile still owns inboxes — move them to another profile first; LinkedIn/WhatsApp accounts detach (return to the pool) and are never deleted. | writes |
oxygen senders profiles detach | Detach LinkedIn/WhatsApp senders from a profile, returning them to the unassigned pool. --mailboxes is refused: an email inbox always belongs to a sender, so there is no unassigned pool for it —… | |
oxygen senders profiles get | Get one sender profile with the LinkedIn/WhatsApp senders and inboxes attached to it. | |
oxygen senders profiles list | List sender profiles with their per-channel account counts (LinkedIn / WhatsApp / inboxes). | |
oxygen senders profiles set-photo | Set the reusable sender identity's profile picture for FUTURE managed-inbox orders made with --sender <id>. | writes |
oxygen senders profiles tag | Replace a sender profile's workspace tags (whole set; --tags "" clears) — one edit pools the whole sending identity behind a campaign tag. | writes |
oxygen senders profiles update | Update a sender profile's own fields (display name, first/last name, avatar, status). | writes |
oxygen senders sync | Refresh LinkedIn account state (status, profile) from Unipile. Pass --connection-id to sync one account, or omit it to sync all. | writes |
oxygen senders tag | Replace a sender account's workspace tags (whole set; --tags "" clears) — e.g. pool the senders behind one campaign tag. See oxygen tags list for the vocabulary. | writes |
sequences
| Command | What it does | Notes |
|---|---|---|
oxygen sequences analytics | Show selected-window sequencer analytics with persisted status kept separate from operational state, fleet marked-active versus operationally-live counts, current open work… | |
oxygen sequences contacts | List a launched campaign's table-backed contacts with full source variables, durable engagement stage, and factual or assigned sender. | |
oxygen sequences contacts-remove | Remove selected source-table rows from this campaign only. | paid |
oxygen sequences create | Create a draft multichannel sequence from a steps JSON file. | paid writes |
oxygen sequences delete | Permanently delete a sequence and everything it owns (enrollments, actions, sender links, schedules). | paid writes |
oxygen sequences draft | Draft an email outreach sequence with AI, grounded in the workspace Knowledge Graph (voice, positioning, campaign learnings) — Instantly's AI sequence generator, with provenance. | paid writes |
oxygen sequences duplicate | Duplicate a sequence as a new DRAFT: copies the step definition, settings, channels, source table, and sender pool. | writes |
oxygen sequences enroll | Enroll leads into a sequence. | writes |
oxygen sequences enrollments | List per-lead enrollment state plus the latest action status, error, attempts, and retry time. | |
oxygen sequences esp | ESP breakdown of this sequence's email sending scope: which provider each enrolled lead's mail routes through (google/microsoft, plus named gateways like Proofpoint/Mimecast and non-matchable… | |
oxygen sequences events | Chronological activity feed for a sequence (like Instantly's Sending Activities): sends, failures, deferrals, opens, clicks, replies, bounces, unsubscribes, and positive reply-status transitions… | |
oxygen sequences get | Get a sequence's definition, senders, status, and credit usage. --readiness adds the launch check — whether it CAN go live, why not, and which mailboxes it would send from — without touching it. | |
oxygen sequences hubspot-list-import configure | Preview or start a scheduled HubSpot-list import. Preview first; then pass its reviewed fingerprint with --live --approved. The complete DNC list is applied before leads are read or enrolled. | paid writes |
oxygen sequences hubspot-list-import lists | List saved HubSpot contact/company segments and readable identity fields available for a Sequence import. | |
oxygen sequences hubspot-sync configure | Preview or save the workspace-wide HubSpot projection. Existing fields need no new grant; creating missing properties requires --approved and HubSpot property-creation access. | paid writes |
oxygen sequences hubspot-sync show | Show the connected portal, live contact schema, activity/status configuration, component health, and enabled state. | |
oxygen sequences list | List sequences with persisted launch status kept separate from current operational state. | |
oxygen sequences pause | Pause an active sequence (stops new dispatches; enrollments resume on un-pause). | writes |
oxygen sequences pause-company | Pause messaging to a company in your campaigns — e.g. after a meeting is booked — and resume it later. | writes |
oxygen sequences paused-companies | List the companies paused in your campaigns — by a reply (waiting for its classification, or classified into a paused status) or by hand/automation — with the leads each one holds. | |
oxygen sequences push-external | Push table rows into a campaign you ALREADY run in an external sequencer (Smartlead, Instantly, lemlist, HeyReach), through your own connected API key. | paid writes |
oxygen sequences reconcile | Safely reconcile one ambiguous LinkedIn invite/message from provider reads. Preview-only unless --approved; never resends. | paid writes |
oxygen sequences recover-capacity | Preview definitive no-effect terminal failures that Oxygen can replay safely: provider-capacity denials and exact allowlisted request-format defects. | writes |
oxygen sequences resume | Resume a paused sequence. | writes |
oxygen sequences resume-company | Resume messaging to a paused company: its held leads continue where they stopped (due steps are spread over the next hour, waits keep their remaining time). | writes |
oxygen sequences retry-deferred | Preview or re-ready pending actions deferred by LinkedIn working hours or an email send window on a PAUSED sequence. | paid writes |
oxygen sequences send | Initiate one net-new LinkedIn message through a one-recipient, one-step hosted Sequence. | paid writes |
oxygen sequences signal | Record an external GTM signal (e.g. linkedin_connected, email_replied, company_raised_funds, job_change, web_visit, intent) onto a running sequence's enrollment(s) to drive signal-triggered… | |
oxygen sequences start | Preview or start a sequence. | paid writes |
oxygen sequences stats | Show one sequence's persisted launch status and current operational state separately, including reasons, open work, lifetime sent/terminal-failed/deferral counts, and the funnel. daily_budget… | |
oxygen sequences update | Update a sequence. | paid writes |
oxygen sequences variants | Generic per-step action/base-variant scoreboard for one sequence, plus native email by_mailbox, by_domain, reply types, rates, and explicit unattributed facts. | |
oxygen sequences workflows configure | Preview or maintain an existing legacy preset. | paid writes |
oxygen sequences workflows list | List the two legacy sequencer presets with armed state, editable config, and ordinary workflow deep-links. |
session
| Command | What it does | Notes |
|---|---|---|
oxygen session output | Register a local session output file or table. | |
oxygen session start | Start a local Oxygen agent session or update a step. | writes |
oxygen session status | Attach a live status message to the current local session. | |
oxygen session usage | Summarize the current local session. Org credit usage is available through billing usage. |
signals
| Command | What it does | Notes |
|---|---|---|
oxygen signals leads-today | List people to contact today, ranked by their most recent GTM intent signal. | |
oxygen signals list | List the raw GTM signal-event feed newest-first (website_visit / profile_view / post_reaction / new_follower), each resolved onto the person it attached to. Read-only. | |
oxygen signals record | Record one inbound GTM signal (website_visit, profile_view, post_engager, new_follower). Internal write — free, no approval. Idempotent on --external-event-id. | writes |
oxygen signals registry | Show the signal-type registry: each registered type with its intent weight and capture status (all four registered types are live end-to-end — website_visit via the RB2B webhook, the engagement… | |
oxygen signals search plan | Compile a signal-sourcing request into ordered provider routes without provider calls: the chain, per-route applied/dropped filters, credit estimate, table blueprint, and whether the route can be… | |
oxygen signals search preview | Preview public LinkedIn posts for free (family linkedin_posts): up to 25 per keyword, with author, engagement and the --ai-filter applied. | |
oxygen signals search run | Return a dry-run request or queue a live signal-search ingestion run. | paid writes |
signup-leads
| Command | What it does | Notes |
|---|---|---|
oxygen signup-leads deliveries get | Get one signup lead webhook delivery by delivery id or event id. | |
oxygen signup-leads deliveries list | List signup lead webhook deliveries for the current organization. | |
oxygen signup-leads deliveries retry | Retry one failed signup lead webhook delivery. | writes |
skills
| Command | What it does | Notes |
|---|---|---|
oxygen skills doctor | Check Oxygen skill index reachability and local installer prerequisites. | |
oxygen skills get | Hydrate one exact Oxygen skill entrypoint and its document index. | |
oxygen skills install | Install Oxygen agent skills into local agent skill directories only; uses 0 credits and does not change the Oxygen workspace or call a provider. | |
oxygen skills list | List Oxygen agent skills available from the hosted skill index. | |
oxygen skills search | Find a bounded set of Oxygen skills and matching documents from an outcome. |
sourcing
| Command | What it does | Notes |
|---|---|---|
oxygen sourcing plan | Classify a sourcing request and recommend provider routes without executing paid tools. |
status
| Command | What it does | Notes |
|---|---|---|
oxygen status | Compare the local Oxygen CLI version against the active profile's deployed Oxygen API. |
supabase
| Command | What it does | Notes |
|---|---|---|
oxygen supabase cancel | Request cancellation of every still-active child table run in an import. | writes |
oxygen supabase catalog | Inspect readable base tables, columns, PostgreSQL types, primary keys, and estimated rows through the saved read-only connection. | |
oxygen supabase connect | Validate and encrypt a managed Supabase PostgreSQL URL. | writes |
oxygen supabase get | Get aggregate and per-table status, row counts, failures, and deep-links for a Supabase import. | |
oxygen supabase import | Start the previously previewed snapshot/refresh as durable Postgres-backed work. | writes |
oxygen supabase plan | Preview exact Oxygen Table creates/refreshes, row-limit posture, deletion semantics, and the schema fingerprint required to start. No writes and 0 credits. | |
oxygen supabase retry | Retry failed child table items without duplicating already-upserted source rows. | writes |
support
| Command | What it does | Notes |
|---|---|---|
oxygen support admin assign | Hand a live Thread to a named human, for escalation past an agent's authority or judgment boundary (staff only). | writes staff |
oxygen support admin claim | Claim a live Plain Thread and move it to In progress without overwriting another assignee (staff only). | writes staff |
oxygen support admin done | Preview or mark a Plain Thread Done after the exact verified agent reply; new customer activity reopens it to Todo (staff only). CLI completion is agent-only. | writes staff |
oxygen support admin draft | Stage a reply as a team-only Plain note; this never sends to the customer (staff and agents). | writes |
oxygen support admin field-set | Record OXYGEN workflow state on a live Thread as structured, filterable Plain data — which version and commit carry a fix, and the PR that shipped it (staff only). | writes staff |
oxygen support admin get | Show one live Plain Thread, its routing metadata, and customer-visible messages (staff only). | staff |
oxygen support admin label-add | Add an active Plain label by external ID (staff only). | writes staff |
oxygen support admin label-remove | Remove a Plain label by external ID (staff only). | writes staff |
oxygen support admin list | List live Plain Threads across customer Tenants (staff only). | staff |
oxygen support admin note | Add a team-only internal note to a live Plain Thread (staff only). | writes staff |
oxygen support admin open | Return the exact Plain Inbox URL for one live Thread (staff only). | staff |
oxygen support admin priority | Set the native Plain priority for a live Thread (staff only). | writes staff |
oxygen support admin reply | Preview or send a guarded public reply on the Thread's native Plain channel as Oxygen Support (staff only). CLI delivery is agent-only; named humans use Plain Inbox or Plain MCP. | writes staff |
oxygen support admin setup | Reconcile the shared Plain workspace against the taxonomy OXYGEN declares in code: request-type labels and intake fields, plus the workflow-state labels and release fields the support loop writes. | writes staff |
oxygen support admin snooze | Park a live Thread until a named time, so work blocked on a release, a provider, or a scheduled retry stops reading as unanswered (staff only). | writes staff |
oxygen support admin start | Set a live Plain Thread to Plain TODO with the In progress detail when OXYGEN work remains after a reply, preserving its assignee (staff only). | writes staff |
oxygen support admin todo | Return a snoozed Thread to the queue when its blocker clears (staff only). Never reopens a Done Thread: Plain does that on real customer activity. | writes staff |
oxygen support chat | Start a Plain Chat conversation from one message, or pass an existing Thread ID to continue it. | writes |
oxygen support file | Create a structured Plain support conversation with a subject and required message. | writes |
oxygen support get | Show one Plain support Thread and its customer-visible timeline. | |
oxygen support list | List Plain support Threads for the active organization. | |
oxygen support reply | Reply to a Plain Chat thread; migrated or native-channel history continues in one linked Chat thread. | writes |
suppressions
| Command | What it does | Notes |
|---|---|---|
oxygen suppressions add | Add (or refresh) a lead provider id on the org do-not-contact list so the sequencer never enrolls them again. Idempotent. --reason defaults to manual. | writes |
oxygen suppressions addresses | List the org's blocked email ADDRESSES, newest first (bounces, unsubscribes, and suppressions import land here). | |
oxygen suppressions companies | List explicit company-domain and LinkedIn-company suppressions. These stop every Sequence channel. | |
oxygen suppressions crm-backfill | Create a CRM person record for everyone already on the do-not-contact list, so you can see who they are. | writes |
oxygen suppressions domains | List the org's whole-domain email blocks, newest first. Filter by --reason (manual | complaint | policy) or --search (case-insensitive substring of the domain). | |
oxygen suppressions hubspot lists | List contact/company saved lists and readable identity properties. Reads definitions only; no memberships or writes. | |
oxygen suppressions hubspot sync | Preview or arm additive HubSpot → DNC sync. Requires at least one contact/company list. Live requires the exact dry-run fingerprint and approval; never enrolls or sends. | paid writes |
oxygen suppressions import | Bulk-import a do-not-contact blocklist from a file (newline / comma / whitespace separated, max 5000). | writes |
oxygen suppressions import-identities | Import a source-neutral typed JSON array into DNC. | writes |
oxygen suppressions import-person | Import one person as one DNC subject with any combination of email, LinkedIn, E.164 phone, and an explicitly supplied company domain. The domain is company-wide and is never inferred from --email. | writes |
oxygen suppressions list | List the org's do-not-contact suppressions, newest first. Filter by --reason or by --search (case-insensitive substring of the lead provider id). | |
oxygen suppressions phones | List phone suppressions (strict E.164) used by call, WhatsApp, and Sequence safety gates. | |
oxygen suppressions policy reset | Return one rule (--rule) or every rule (--all) to the shipped default. | writes |
oxygen suppressions policy set | Change one rule. Example: oxygen suppressions policy set --rule linkedin_reply --effect stop_only stops a LinkedIn replier's current campaign without blocking them from every future one. | writes |
oxygen suppressions policy show | Show every do-not-contact rule with its current setting, whether that is your change or the shipped default, and the values it accepts. | |
oxygen suppressions remove | Remove one lead provider id (--lead), or every identity of one merged person (--subject-id), from the org do-not-contact list (re-enable contact). | writes |
oxygen suppressions remove-address | Remove one blocked email ADDRESS from the do-not-contact ledger (re-enables sending to it). | writes |
oxygen suppressions remove-company | Deliberately remove one explicit company suppression. | writes |
oxygen suppressions remove-domain | Remove a whole-domain email block (re-enable sending to the domain). | writes |
oxygen suppressions remove-phone | Deliberately remove one strict E.164 phone suppression. | writes |
table-ingestions
| Command | What it does | Notes |
|---|---|---|
oxygen table-ingestions cancel | Request cancellation for a durable table ingestion run. | writes |
oxygen table-ingestions create-tool-page | Create a paged tool-source ingestion run for a workspace table. | paid writes |
oxygen table-ingestions get | Get one durable table ingestion run. | |
oxygen table-ingestions items | List items for a durable table ingestion run. | |
oxygen table-ingestions retry-failed | Requeue failed items for a durable table ingestion run. | writes |
oxygen table-ingestions wait | Wait for a table ingestion run (read-only, no credits). Retries transient network failures, including deploy disconnects, at the polling interval within the same timeout. |
table-runs
| Command | What it does | Notes |
|---|---|---|
oxygen table-runs cancel | Request cancellation for a durable table action run. | writes |
oxygen table-runs create | Create a durable background run for table tool-column actions. | paid writes |
oxygen table-runs effect-unknown | List the items of a run whose external write was dispatched but never confirmed. Oxygen will not retry them on its own: verify each destination, then record what you found with oxygen cells resolve. | |
oxygen table-runs get | Get one durable table action run. | |
oxygen table-runs items | List row items for a durable table action run. | |
oxygen table-runs list | List durable table action runs for one table. | |
oxygen table-runs pause | Pause a durable table action run before it starts more row jobs. | writes |
oxygen table-runs provider-summary | Summarize provider attempts, upstream request events, and credit capture/release for a table action run. | |
oxygen table-runs resume | Resume a paused durable table action run. | writes |
oxygen table-runs retry-failed | Requeue failed items for a durable table action run. Items with an unconfirmed external effect stay blocked until their destination is verified and explicitly approved. | paid writes |
oxygen table-runs wait | Poll a durable table action run until it finishes. |
tables
| Command | What it does | Notes |
|---|---|---|
oxygen tables activity | Show background runs active on a workspace table right now, with a worker-queue health rollup. | |
oxygen tables archive | Archive a workspace table without dropping physical data. Hides it indefinitely with no purge timer; for cleanup with a restorable deadline use tables delete. | writes |
oxygen tables auto-dedupe disable | Disable (clear) a table's standing auto-dedupe configuration. | writes |
oxygen tables auto-dedupe get | Show a table's standing auto-dedupe configuration. | |
oxygen tables auto-dedupe set | Enable a standing auto-dedupe: after every write (insert, upsert, import, send, webhook), duplicate groups containing a just-written row are collapsed by the keep policy — losers are DELETED… | writes |
oxygen tables auto-run disable | Disable (clear) a table's standing auto-run configuration. | writes |
oxygen tables auto-run get | Show a table's standing auto-run configuration (columns queued automatically when new rows are written). | |
oxygen tables auto-run set | Enable a standing auto-run: automatically queue the given columns for rows written to this table (imports, inserts, upserts). | paid writes |
oxygen tables create | Create a real Postgres-backed workspace table. Free — 0 Oxygen credits. To create a table and import a file in one step, use tables import --create <name>. | writes |
oxygen tables dedupe | Collapse duplicate rows by normalized (email/domain/linkedin) or fuzzy-label keys, or cross-check a column against another table. | paid |
oxygen tables delete | Delete workspace tables: archives now and schedules the physical purge (default 14 days; restorable via tables restore until then). --now purges immediately and permanently — it previews and… | writes |
oxygen tables delete-row | Delete one workspace table row. | writes |
oxygen tables delete-rows | Delete multiple workspace table rows. | writes |
oxygen tables describe | Describe a workspace table and its columns. | |
oxygen tables duplicate | Duplicate a workspace table. Copies row values unless --schema-only is set. | writes |
oxygen tables export | Export workspace table rows as JSON, JSONL, CSV, or a human-readable table. Rows only, capped at 1000; to copy a whole table including its columns and every row, use tables export-bundle. | |
oxygen tables export-bundle | Export a workspace table as a portable bundle (schema + every row) for cross-environment / cross-org copies. | |
oxygen tables followers check | Free: read the page's follower count and quote the exact credits an order would reserve. No spend, no table; orderable: false means no order can be placed yet. | |
oxygen tables followers order | Place the follower order after checking it. | paid writes |
oxygen tables hubspot import | Preview or import HubSpot contacts/companies into a new table or Records. | paid writes |
oxygen tables hubspot lists | List the connected portal's saved contact/company segments and readable identity properties. | |
oxygen tables import | Import JSON, JSONL, CSV, or XLSX rows into a workspace table. | writes |
oxygen tables import-bundle | Recreate a workspace table from an export-bundle file in this org. | writes |
oxygen tables insert | Insert rows into a workspace table. Table writes cost 0 Oxygen credits; paid column runs are separate. | writes |
oxygen tables link | Link two tables: Oxygen finds the column that joins them, works out the direction, shows you how many rows will match, and on approval links every row. | paid |
oxygen tables list | List workspace tables in the current tenant database. | |
oxygen tables move | Move one or more workspace tables into a project (folder) in one call. Rows, columns, runs, and provenance are preserved. Free; reverse it by moving the table back. | writes |
oxygen tables pipedrive filters | List the connected Pipedrive account's saved people/organization filters and its person/organization fields (custom-field keys included). | |
oxygen tables pipedrive import | Preview or run a Pipedrive saved people filter into a NEW table. | paid writes |
oxygen tables preview | Preview a workspace table with projected rows and summary stats. | |
oxygen tables promote | Write bound rows' columns onto their matched CRM records (Records<->Tables). | paid |
oxygen tables query | Query a workspace table by id or slug. Output is a JSON envelope; for a typed, human-readable rendering of the same rows use tables export <table> --format table. | |
oxygen tables recover-pending | Re-poll BetterContact async enrichments that timed out mid-poll and write any newly-found phones back to the table. | writes |
oxygen tables relate | Relate two tables: define empty Tables-owned relation columns on the source and target. | |
oxygen tables relations archive | Archive a native relation, its active links, and both relation columns while preserving history. Previews by default. | paid writes |
oxygen tables relations list | List the native relations visible from one table, including cardinality, target, and active link count. | |
oxygen tables relations update | Rename either side of a relation or change its cardinality. Endpoints and slugs stay immutable. Previews by default. | paid writes |
oxygen tables rename | Rename a workspace table display name and slug. | writes |
oxygen tables restore | Restore an archived or delete-scheduled table: cancels the purge timer and reclaims its slug. | writes |
oxygen tables schedule list | List a table's scheduled column refreshes. | |
oxygen tables schedule remove | Remove a column's scheduled refresh (deletes the backing cron workflow; future scheduled runs stop). | writes |
oxygen tables schedule set | Create or replace a column's scheduled refresh (a cron-triggered hosted workflow; visible via oxygen workflows list). | paid writes |
oxygen tables send | Copy rows from one table into another as a durable background run (free, resumable). | writes |
oxygen tables sources | List every way a table can start — imports, company/people/signal sources, webhooks, functions — with the provider count and per-row credit estimate behind each. | |
oxygen tables tag | Replace a table's workspace tags (Tags primitive; "" clears). Tags link the table to sequences, wiki pages, and workflows carrying the same tag — browse with oxygen tags get <tag>. | writes |
oxygen tables tidy-suggest | Read-only tidy analysis for a workspace table: duplicate columns, formatting issues, hide candidates, and value-sanity findings. | |
oxygen tables unlink | Unlink one exact pair of rows by archiving their relation edge. The relation definition and both rows remain. Previews by default. | paid |
oxygen tables update | Update one workspace table row. | writes |
oxygen tables upsert | Insert or update rows in a workspace table by a column key. | writes |
oxygen tables views create | Create a saved view. | writes |
oxygen tables views delete | Delete a saved view by id. | writes |
oxygen tables views get | Get one saved view by id. | |
oxygen tables views list | List a table's saved views. | |
oxygen tables views update | Update a saved view. | writes |
oxygen tables watcher create | Create and activate a Professional Network Post Engagers table after approval of its exact preview. Starts collection now and daily at 07:00 UTC under the approved per-cycle cap. | paid writes |
oxygen tables watcher get | Read a table's Professional Network Post Engagers configuration and status. Free. | |
oxygen tables watcher pause | Pause daily monitoring while retaining the table and collected rows. | writes |
oxygen tables watcher preview | Free configuration and credit preview: no provider calls, writes, or scheduling. Omit --max-credits for a recommendation and preview hash. Ask for real profile URLs; never invent them. | |
oxygen tables watcher resume | Resume paid daily monitoring after reviewing a fresh preview and approving its per-cycle credit cap. | paid writes |
oxygen tables watcher update | Edit watched profiles or the per-cycle cap from the table. Preview the changes first; approval binds the exact new configuration. | paid writes |
oxygen tables webhook create | Create a direct webhook endpoint that writes inbound JSON into a table (600–12,000 requests a minute by plan size, per endpoint and sender IP; 429 returns Retry-After; oxygen limits show lists… | writes |
oxygen tables webhook deliveries | List direct table webhook deliveries and auto-run enqueue status. | |
oxygen tables webhook get | Get one direct table webhook by endpoint id. | |
oxygen tables webhook list | List direct table webhooks. | |
oxygen tables webhook update | Update a direct table webhook endpoint. | writes |
tags
| Command | What it does | Notes |
|---|---|---|
oxygen tags create | Declare a tag before anything carries it, with an optional description, color, and pin. Idempotent: run it on a tag already in use to annotate it — carriers are never touched. | writes |
oxygen tags delete | Delete one or more tags: strips them from EVERY carrier (archived and finished items included) and removes their declaration. | writes |
oxygen tags get | Everything carrying one tag — publishing posts, knowledge pages, sequences, tables, workflows, recipes, inbox conversations, CRM records, mailboxes, sender accounts, sending domains, projects… | |
oxygen tags list | List every workspace tag with per-primitive counts, most-used first. | |
oxygen tags merge | Merge one or more tags into a single target, EVERYWHERE they appear (archived rows included). | writes |
oxygen tags rename | Rename one tag EVERYWHERE it appears (every primitive, archived rows included). | writes |
oxygen tags update | Change a tag's description, color, or pin. Only the flags you pass change; use the --clear-* flags to remove a value. To change the LABEL use tags rename. | writes |
tools
| Command | What it does | Notes |
|---|---|---|
oxygen tools enums get | Fetch the accepted values for one provider enum catalog. Use this before drafting payloads with enumRef fields. | |
oxygen tools enums list | List enum catalogs for a provider (or all providers). | |
oxygen tools favorite | Favourite one column-catalog entry for this workspace: a native column (find_email, preset:person_enrich, prompt:icp_fit_score_v1) or a vendor tool (tool:<tool_id>). | |
oxygen tools favorites | List your favourite column-catalog entries for this workspace, with each native entry's per-row price. | |
oxygen tools get | Get a tool descriptor. | |
oxygen tools run | Run an executable Oxygen tool through the HTTPS API. | paid writes |
oxygen tools search | Search the priced catalog (0 credits): provider operations in tools, and OXYGEN's own columns in native_columns (enrichment bundles, waterfalls, templates, Functions), each with price_label… | |
oxygen tools unfavorite | Remove one column-catalog entry from your favourites for this workspace. |
ugc
| Command | What it does | Notes |
|---|---|---|
oxygen ugc amplification get | Read this program's current amplification authority and immutable action history. Master workspace only; 0 credits, no provider call. | |
oxygen ugc amplification reconcile | Preview recording a provider observation for an uncertain program action. Confirmation needs a signed-in operator and --approved; it never contacts the provider or authorizes a retry. | writes |
oxygen ugc amplification save | Save exact opted-in sender scope and bounded post-specific amplification. Enabling needs explicit approval. | paid writes |
oxygen ugc analytics get | Read UGC analytics in the active workspace. Read-only. The brand workspace sees every creator; a creator workspace only ever gets its own row, with or without --participation-id. | |
oxygen ugc applications list | Applications to public programs. Without --program-id: the ones this creator workspace sent, with status. With --program-id: the ones your program received (brand), pending first. Read-only. | |
oxygen ugc calendar list | Read the program's enrolled post calendar in a bounded UTC date range (up to 42 days). Stored data only, 0 credits. | |
oxygen ugc creators accept | Accept an exact invitation in the creator workspace. Check it first with creators invitation --token; a refusal names its reason (wrong account, the program's own workspace, withdrawn or expired). | writes |
oxygen ugc creators approve | Approve a pending application to your program (from applications list --program-id). The applicant becomes a creator at once and is emailed. Free: 0 credits. | writes |
oxygen ugc creators decline | Decline a pending application to your program. No email is sent. Free: 0 credits. | writes |
oxygen ugc creators invitation | Read what an invitation link points at before accepting it: the program, the invited email (masked), the posting deal, and can_accept with the reason when this account or workspace cannot accept it. | |
oxygen ugc creators invite | Preview an invitation email (0 credits) for one creator (--email) or up to 50 at once (--emails); send with --approved --preview-token from that preview and the same recipients. | writes |
oxygen ugc creators list | Read creators (name, picture, LinkedIn URL and posting_target, their own deal; null follows the program standard) and invitations, including persisted email delivery status. Read-only. | |
oxygen ugc creators revoke-invite | Revoke an unaccepted invitation. | writes |
oxygen ugc creators send-invite | Preview email for an existing pending invitation; send or resend with --approved --preview-token. Replaces the old link, keeps its expiry. Sent means provider accepted, not inbox delivery. | writes |
oxygen ugc creators set-target | Set one creator's own posting deal, e.g. 1/month while the program asks for 2/month, on a joined creator (--participation-id) or a pending invitation (--invitation-id). none returns them to the… | writes |
oxygen ugc creators update | Connect an existing LinkedIn sender, change approval authority, or leave the entire program. | writes |
oxygen ugc knowledge list | Read UGC knowledge in the active workspace. Read-only. | |
oxygen ugc memberships list | Read active program memberships for the creator workspace. Free, stored and provider-free. | |
oxygen ugc peer-amplification get | Read this creator's own peer-engagement policy, host gate, readiness and immutable receipts. Creator workspace only; free and provider-free. | |
oxygen ugc peer-amplification reconcile | Preview recording observed evidence for this creator's effect_unknown peer action. Approval records the outcome without a provider call or retry. | writes |
oxygen ugc peer-amplification save | Preview or save this creator workspace's own peer-engagement consent, sender, voice and caps. The creator wallet pays; the host gate must also be enabled. | paid writes |
oxygen ugc posts approve | Record creator or explicitly delegated operator approval of the current post. | paid writes |
oxygen ugc posts brand-approve | Record separate master brand approval of the current post. | paid writes |
oxygen ugc posts comment cancel | Cancel a scheduled comment before it runs, including one still waiting for its post. Organizer workspace only; a comment that is already posting or posted cannot be cancelled. | writes |
oxygen ugc posts comment schedule | Schedule one exact comment on a creator's program post from one of this workspace's LinkedIn accounts; on a post not live yet it waits. | paid writes |
oxygen ugc posts draft | Draft a post from your topic in your voice, grounded in the program's shared pages. A bare call is a free preview; the creator repeats it with --request-id --approved --max-credits to run it. | paid writes |
oxygen ugc posts draft-status | Read the original paid draft request and saved result without generating again. Creator workspace only, 0 credits. | |
oxygen ugc posts enroll | Enroll one existing creator-owned post in this participation. | writes |
oxygen ugc posts history | Read retained public comments, metrics, and publication receipts for one enrolled post. Stored data only, 0 credits. | |
oxygen ugc posts list | Read UGC posts in the active workspace. Read-only. | |
oxygen ugc posts remove | Remove one creator-owned post from a program before publication while retaining immutable enrollment history. The personal draft remains in Publishing. | writes |
oxygen ugc posts update | Edit or schedule an enrolled post with creator or delegated authority; publishing gates still apply. | writes |
oxygen ugc profile get | Read your creator profile (topics, audience and LinkedIn profile URL). Free, read-only. | |
oxygen ugc profile update | Save your creator profile, which brands whose programs you joined can read. --topics replaces the list; --audience "" clears it. Free: 0 credits. | writes |
oxygen ugc programs apply | Apply to a public program from programs discover, with a short note to the brand. The brand approves or declines; approval makes you a creator in the program and emails you. Free: 0 credits. | writes |
oxygen ugc programs archive | Archive a program: stop future access, publishing, tracking and amplification, revoke pending invitations and request cancellation of sponsorship renewals. | writes |
oxygen ugc programs create | Create a master UGC program from its product link. The name defaults to the site's name and its icon is fetched from the site. Free: 0 credits, no provider call. | writes |
oxygen ugc programs delete | Permanently delete a program and its pending invitations. | writes |
oxygen ugc programs discover | Public programs from every brand on Oxygen that you can apply to, with each brand's deal and brief excerpt, and whether you already joined or applied. Free, read-only. | |
oxygen ugc programs duplicate | Copy a program's settings, shared knowledge, brand review and posting target into a new active program. Free: 0 credits. Never copies creators, invitations, posts or sponsorship. | writes |
oxygen ugc programs get | Read UGC program in the active workspace. Read-only. | |
oxygen ugc programs list | Read UGC programs in the active workspace, archived ones included unless --status filters. Read-only. | |
oxygen ugc programs restore | Restore an archived program. Creators removed earlier stay removed, revoked invitations stay revoked, and cancelled sponsorships need a new preview and confirmation. | writes |
oxygen ugc programs update | Update program settings and selected shared knowledge. | writes |
oxygen ugc sponsorship cancel | Preview stopping renewal for one program sponsorship. Confirm with --approved and a signed-in master admin. The paid period stays; a credit sponsorship stops without a card provider call. | writes |
oxygen ugc sponsorship confirm | Confirm the exact sponsorship quote as the same signed-in master admin. Card quotes return checkouts; credit quotes start the reservations or fail with insufficient_credits. | paid writes |
oxygen ugc sponsorship get | Read sponsorship in the active workspace. Creators see their remaining credits and exact organizer access; masters see program payment status. Read-only. | |
oxygen ugc sponsorship preview | Preview sponsoring creators as a signed-in master admin: funding is card (seat plus 10,000-credit grant) or credits (one LinkedIn reservation per creator). Org API keys cannot quote. | |
oxygen ugc voice get | Read UGC voice in the active workspace. Read-only. | |
oxygen ugc voice import | Preview all retrievable LinkedIn history and voice inference; approve a total credit ceiling to start. Use --import-id to resume a safely interrupted import with its saved progress and spend. | paid writes |
oxygen ugc voice save | Save your own writing preferences and examples as a private provisional Knowledge voice. | writes |
update
| Command | What it does | Notes |
|---|---|---|
oxygen update | Update the Oxygen CLI from npm, then refresh the Oxygen agent skills in the global skill folders of Codex, Claude Code and Cursor (OXYGEN_SKIP_SKILLS=1 skips that). | writes |
verify
| Command | What it does | Notes |
|---|---|---|
oxygen verify email | Verify one or more email addresses. | paid |
viewers
| Command | What it does | Notes |
|---|---|---|
oxygen viewers enrichment | Turn automatic full-profile enrichment of NEW profile viewers on or off for the viewers table (Up2Data profile: about, current role and company, experience, education, location). | writes |
oxygen viewers import | Start (or re-arm, or resume a paused account) a durable profile-viewers (WVMP) import. | writes |
oxygen viewers pause | Switch the profile-viewers import off for one account or all: rows and the table stay exactly as they are, and viewers import --account <ref> switches it back on. | writes |
oxygen viewers status | Show durable profile-viewers (WVMP) import progress: accounts[] lists every connected LinkedIn account with its display_name, headline, picture_url, per-account on (true when switched on… |
visuals
| Command | What it does | Notes |
|---|---|---|
oxygen visuals download | Download a file with SHA-256 verification; refuses to overwrite existing local files. | |
oxygen visuals file-get | Read source, file metadata, provenance and web/download links. | writes |
oxygen visuals render-cancel | Request cancellation; read state to verify it stopped. | |
oxygen visuals render-get | Read render state and output downloads; optionally wait for a terminal state. | |
oxygen visuals render-preview | Preview rendering without starting paid compute. | |
oxygen visuals render-start | Approve an exact preview and enqueue one idempotent render job. | paid |
oxygen visuals source-create | Save an immutable HTML/CSS/SVG source revision; no code executes. |
voice
| Command | What it does | Notes |
|---|---|---|
oxygen voice numbers buy | Buy phone numbers for the dialer. | paid writes |
oxygen voice numbers cap set | Set one phone number's daily dial cap (dials per day, 1-300; new numbers get 100). | writes |
oxygen voice numbers list | List the org's phone numbers with warm-up state, daily cap, and what each one costs per month. Optional --tag narrows to one campaign's numbers. | |
oxygen voice numbers release | Give a number back to the carrier and stop its monthly charge. | writes |
oxygen voice numbers requirements | What a country demands before it sells a number (business details, documents). Free, and read live from the carrier. | |
oxygen voice numbers search | Find numbers you could buy, by area code or region. Free: searching buys nothing and reserves nothing, so a listed number can be gone by the time you buy it. | |
oxygen voice numbers tag | Replace a phone number's workspace tags (whole set; --tags "" clears) — e.g. pool the numbers dialing one campaign behind its tag. See oxygen tags list for the vocabulary. | writes |
oxygen voice tasks claim | Take the next due call task, or a specific one with --task. | writes |
oxygen voice tasks complete | Record the outcome of a claimed call. Lease-guarded: a lease reclaimed mid-call fails with 409 rather than overwriting the new holder's outcome. | |
oxygen voice tasks extend | Renew a claimed task's 15-minute lease. Completing needs a live lease, so a longer call must heartbeat or its outcome and notes are rejected as stale. | |
oxygen voice tasks list | List the call queue, best-first (highest priority, then earliest due). Defaults to every status; filter with --status. | |
oxygen voice tasks override | Waive a guardrail for ONE lead — the exception path for a prospect who asked to be called outside their window, or one whose timezone you know you do not have. | |
oxygen voice tasks queue | Put a lead INTO the call queue. | |
oxygen voice tasks skip | Drop a task out of the queue without dialing (bad data, a rep pass, a guardrail block). Needs no lease — the guardrail gate skips tasks it never claimed. |
| Command | What it does | Notes |
|---|---|---|
oxygen whatsapp accounts | List connected WhatsApp accounts with health status, warm-up ramp state, limits, and today's usage. Disconnected accounts are hidden unless you pass --status disconnected. | |
oxygen whatsapp chat-action | Act on one WhatsApp chat: read/mute/archive/pin state, labels, group membership, or the group invite link. | paid writes |
oxygen whatsapp connect | Get a Unipile hosted-auth URL to connect a new WhatsApp account by scanning a QR in WhatsApp → Linked Devices (or reconnect with --reconnect). Newly connected accounts start a mandatory warm-up ramp. | writes |
oxygen whatsapp disconnect | Disconnect a WhatsApp account so it stops sending and frees its sending seat for another account. | writes |
oxygen whatsapp forward | Forward an existing WhatsApp message into another chat. This delivers a new message, so it spends send budget and is approval-gated: omit --approved for a preview. | paid writes |
oxygen whatsapp get | Get one WhatsApp account with limits, warm-up ramp state (account age + today's effective send ceiling), daily-reset timezone, and usage. | |
oxygen whatsapp history | Backfill one WhatsApp conversation's full message history. | writes |
oxygen whatsapp limits get | Show current WhatsApp limits, the warm-up ramp state, direct-versus-Sequence delivery policy, daily-reset timezone, defaults, and safe maximums. <id> accepts an account id, connection id, or… | |
oxygen whatsapp limits set | Adjust per-account WhatsApp daily limits and the daily-reset timezone. | writes |
oxygen whatsapp profile edit | Edit the connected number's WhatsApp profile. Every contact who has the number sees the change, so this is approval-gated: omit --approved for a preview. | paid writes |
oxygen whatsapp profile show | Show the connected number's WhatsApp profile. | |
oxygen whatsapp sync | Refresh WhatsApp account state (status) from Unipile. Pass --connection-id to sync one account, or omit to sync all. | writes |
oxygen whatsapp warm-send | Send ONE warm WhatsApp message into an EXISTING conversation (warm-only; a cold phone number with no prior conversation is rejected). | paid writes |
whoami
| Command | What it does | Notes |
|---|---|---|
oxygen whoami | Show the current Oxygen CLI identity. |
worker
| Command | What it does | Notes |
|---|---|---|
oxygen worker failures | List failed background action and ingestion items. | |
oxygen worker queue-stats | Show background action and ingestion queue health. | |
oxygen worker repair | Repair stale background action, ingestion, and workflow queue state. | |
oxygen worker run-once | Compatibility alias for worker repair; repairs Postgres-backed worker state for the current organization. | writes alias |
workflows
| Command | What it does | Notes |
|---|---|---|
oxygen workflows apply | Compile and save a workflow definition; --draft appends an editable revision without publishing it. | paid writes |
oxygen workflows approvals | List workflow runs awaiting a human approval decision (the mid-run approval inbox). | |
oxygen workflows call | Run a workflow — or preview it first. | paid writes |
oxygen workflows cancel | Cancel a queued or running workflow run. | writes |
oxygen workflows delete | Preview or permanently delete one or more workflow automations. | writes |
oxygen workflows disable | Disable one or more workflow automations and their current triggers. | writes |
oxygen workflows duplicate | Duplicate a workflow automation as a disabled copy by default. | writes |
oxygen workflows enable | Enable one or more workflow automations and their current triggers. | paid writes |
oxygen workflows events emit | Emit a normalized workflow event and enqueue matching event-triggered workflows. | paid writes |
oxygen workflows events get | Get one curated workspace-event preset and its ready-to-copy trigger object. | |
oxygen workflows events list | Search and filter every registered app-native and connected event this workspace can use as a workflow trigger, including setup-required events. | |
oxygen workflows export | Export one graph-native workflow as a portable, editable definition with source account ids and trigger authority removed. | |
oxygen workflows failures | List failed workflow runs and trigger scheduler failures. | |
oxygen workflows get | Get one workflow automation, including any cron slowdown to your plan's minimum interval. | |
oxygen workflows import | Preflight or install a portable workflow definition. Imports are create-only and always disabled. | writes |
oxygen workflows init | Create a local editable workflow graph. Use --format recipe only for the legacy durable-recipe authoring path. | |
oxygen workflows lint | Compile and validate an authored workflow file against the same draft/publish readiness contract as the web editor and apply. | |
oxygen workflows list | List workflow automations. | |
oxygen workflows mcp disable | Unpublish a workflow's MCP tool. The workflow stays active and callable via oxygen workflows call. | writes |
oxygen workflows mcp enable | Publish an active workflow as a callable MCP tool so any MCP client can run it. The published tool appears to MCP clients as oxygen_workflow_<slug>. | writes |
oxygen workflows mcp list | List workflows currently published as MCP tools. | |
oxygen workflows rename | Rename a workflow automation's display name only — its id and slug are unchanged, and the next workflows apply from source overwrites the name. | writes |
oxygen workflows resume | Approve or reject a paused mid-run workflow approval, resuming the run. | writes |
oxygen workflows retry | Preview retrying a failed run from its first failed step. Completed steps stay preserved; ambiguous external writes are refused. | paid writes |
oxygen workflows revisions | Saved revision history for one workflow, newest first — includes unpublished drafts and published versions; use --include-manifest to inspect either. | |
oxygen workflows revisions restore | Re-publish an earlier version as the newest one. | paid writes |
oxygen workflows run | Read one workflow run, including waiting and awaiting_approval pause state. This command changes nothing. | |
oxygen workflows runs | List workflow runs. | |
oxygen workflows schema | Print workflow JSON schemas. | |
oxygen workflows tag | Replace a workflow's workspace tags (Tags primitive; "" clears). | writes |
oxygen workflows tail | Poll until a workflow finishes or parks in waiting/awaiting_approval; clock waits resume automatically. | |
oxygen workflows templates apply | Deprecated alias for oxygen blueprints apply. Creates a disabled workflow (plus its tables, columns, and prompts) from a blueprint. | paid writes deprecated |
oxygen workflows templates describe | Deprecated alias for oxygen blueprints describe. | deprecated |
oxygen workflows templates preflight | Deprecated alias for oxygen blueprints preflight. Validates inputs and previews effects without running. | paid deprecated |
oxygen workflows templates run | Removed: returns a typed 410 deprecation. Use oxygen blueprints apply <slug> then oxygen workflows call <workflow>. | paid writes deprecated |
oxygen workflows templates search | Deprecated alias for oxygen blueprints list. Searches Oxygen blueprints (seed templates plus saved blueprints). | deprecated |
oxygen workflows webhooks deliveries | List inbound workflow webhook deliveries: what arrived, whether it verified, and the run it started. Replays never append here; only a verified outcome=ran delivery can be replayed. | |
oxygen workflows webhooks replay | Create a durable, inspectable run in dry_run mode from one verified outcome=ran delivery's exact original revision and payload. | writes |
oxygen workflows webhooks rotate | Replace a workflow webhook's shared secret. Previews by default; the old sender secret stops working immediately after approval. | writes |
workspace
| Command | What it does | Notes |
|---|---|---|
oxygen workspace infrastructure-exit | Leave, close or offboard a workspace's managed external infrastructure in one action. | paid writes |
oxygen workspace map | What this workspace actually contains: the newest tables, CRM objects, sequences, workflows, agents, wiki pages, posts and projects, each with its id, last activity, tags and link. |