Agency directory
Apply for, edit, publish, and pull your agency's listing in the public OXYGEN directory.
Get your agency onto oxygen-agent.com/agencies, then edit or unpublish that listing from the web app or the CLI.
The directory is invite-only. Until OXYGEN staff enable a listing for your organization, oxygen directory get returns directory_not_enabled and the settings screen shows an application form instead of the editor.
Apply
Two routes:
- Web — open
oxygen-agent.com/settings/directory, fill in Your agency website and Tell us about your agency, press Submit application. - CLI:
oxygen directory apply \
--message "What we do, who we serve, and how we use OXYGEN for client work" \
--website https://your-agency.comApplying files a support request with the OXYGEN team. It costs 0 credits, creates no listing, and publishes nothing. One open application per organization — apply twice and you get back status: "already_applied".
If staff approve, they create the listing in invited status and seed its name and public slug. They may also prefill fields and set featured placement. That gives you an editor, not a live page; an update never publishes a draft.
Find the editor
/settings/directory is a deep link only. It has no sidebar entry and is not in the Settings popover in the sidebar footer. CLI and MCP responses hand you the URL as settings_url, and the public directory's Apply to be listed button points at it.
Once a listing exists, an Agency Directory tab also appears in the settings dialog: sidebar footer Settings → Organisation settings → Agency Directory (/settings#/agency-directory). Organizations without a listing never see that tab.
Edit the profile
The editor autosaves: text fields save when you leave them, the Services and Regions served chips save shortly after you toggle them. Fields are Agency name, URL slug, Tagline, Logo (Upload image takes PNG, JPEG, WebP, or SVG up to 2 MB), Description, Founding team (Add founder), Website, Company LinkedIn, Book-a-call link, and Contact email.
The same edits from the CLI:
oxygen directory get --json
oxygen directory update --tagline "GTM systems for seed-stage B2B SaaS" --website https://your-agency.comoxygen directory update --help prints every field flag plus the fixed Services and Regions values the form offers as chips. --profile-json sends a whole profile object under the API field names (website_url, booking_url, …); individual flags override it, and a null in that object is the only way to clear a field — an empty flag value is ignored.
On a published listing every save is public immediately — in the web editor that includes autosave. Unpublish first if you want to rework the copy.
Publish and unpublish
Publishing requires a tagline, a description, and at least one contact method (website, booking link, contact email, or company LinkedIn). Miss any of those and the call fails with directory_profile_incomplete, naming what to add.
- Web — Publish to directory. Once live, that button becomes Unpublish.
- CLI —
oxygen directory publishandoxygen directory unpublish.
Neither spends credits, and neither writes to any platform outside OXYGEN. Both change a public web page, so run them only when you mean to. Unpublishing returns the listing to an editable draft; it does not delete it.
| Status | Badge in the editor | What it means |
|---|---|---|
invited | Draft — not public | Editable, nothing public yet |
published | Published | Live at oxygen-agent.com/agencies/<your-slug> |
delisted | Removed by OXYGEN | Pulled by staff, read-only — contact support |
Once you are live
A published listing makes you an OXYGEN Certified Partner, or Featured Partner if staff pinned you. The editor then shows a Partner program panel with your badge in dark and light — Download SVG each, or Copy embed code for a badge that links back to your listing — and the affiliate rate: 30% on the first 12 months of every customer you refer. The Activate your affiliate link link appears only on deploys where the affiliate portal is configured.
Collaboration
Comment threads, approval requests assigned to a named person, the opt-in gate that blocks a live launch, and the restricted client role.
Knowledge Graph
Run the workspace wiki: write wikilinked pages, pin the canonical copy that grounds AI drafts, and clear the approval queue those pins create.