Changelog

CloudX CLI release history

[0.33] - 2026-05-21

Config validation, line-item edits, and publishing

CloudX CLI 0.33 adds the ability to edit line items directly from your configuration workflow, publish reviewed drafts, and validate local YAML files or remote configs.

To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

• Config validation — Added cloudx config validate [file] for validating local YAML files, plus remote validation of the live config, a published version, or a draft by ID. Use --strict to fail on warnings. Read the docs →
• Line-item writes — Added cloudx config edit create-line-item, cloudx config edit update-line-item, and cloudx config edit delete-line-item for preparing line-item changes in a draft config. Draft edits run validation and never publish automatically. Read the docs →
• Configuration publishing — Added cloudx config publish --id <draft-id> to publish a validated draft as the live config. Read the docs →
• CLI upgrade notice — The CLI now shows a terminal notice when the CloudX API reports that a newer CLI version is available, with a link to update instructions.

[0.32] - 2026-05-13

To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

• API-key authentication — CLOUDX_API_KEY support for CI, scheduled jobs, scripts, and other non-interactive workflows. API keys are managed by administrators in Settings > API Keys. Read the docs →
• CloudX breakdown reporting — cloudx report breakdown --by <dimensions> --metrics <metrics> for CloudX-only aggregate reporting across requests, impressions, revenue, fill rate, eCPM, clicks, and CTR.
• Report granularity and controls — cloudx report dashboard and cloudx report export support --granularity daily|hourly; breakdown reports add hourly buckets, sorting, and filters with --granularity hourly, --top, --bottom, and --having.
• Configurable request timeout — Global cloudx --timeout <duration> for API requests. The default remains 1m, and values are capped at 2m. Read the docs →

[0.31] - 2026-05-07

Cross-mediator report sources

CloudX CLI 0.31 adds report source filtering for publishers that forward impression-level revenue data from external mediation platforms. Existing report commands stay CloudX-only by default, and --source can be used to opt into mediator ILRD where supported.

To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

• Report source filtering — Added --source to cloudx report dashboard, cloudx report apps, and cloudx report ad-units. Use --source all for CloudX plus all available external mediator sources, --source applovin for one mediator, or --source cloudx,applovin for side-by-side comparison.
• Source-aware report metrics — Dashboard, app, and ad-unit reports can now include external mediator ILRD for revenue, impressions, eCPM, and revenue share. Fill rate remains CloudX-only when external mediators are included because external ILRD does not include CloudX request counts.
• Clearer source semantics — --source uses the mediator/platform source from ILRD, such as applovin, not downstream demand network names such as ADMOB_BIDDING. Read the docs →

[0.30] - 2026-05-06

Auction list performance and timeout handling

CloudX CLI 0.30 focuses on making auction inspection more reliable during heavier searches and making timeout failures easier to understand.

To update an existing Homebrew installation to this release:

brew upgrade cloudx

Improved

• Faster auction lists with ILRD filters — Improved cloudx auction list performance when working with ILRD-heavy searches, especially when narrowing results by external ILRD and mediator.
• Longer default request timeout — Increased the default CLI timeout to 60 seconds, giving heavier requests more time to complete.
• Clearer timeout errors — Timeout failures now show a clearer CLI message instead of a low-level networking error.
• Better timeout visibility — Timed-out CLI requests are easier for CloudX support to identify and diagnose.

[0.29] - 2026-05-05

Auction and config inspection

CloudX CLI 0.29 expands the terminal workflow from reporting into production debugging. You can now inspect auctions, rounds, bids, ILRD payloads, live configs, drafts, and published config history without switching to the dashboard.

To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

• Auction inspection — Added cloudx auction list, cloudx auction show, cloudx auction rounds, and cloudx auction bids for reviewing auction records, related rows, aggregate round metrics, bid and non-bid rows, floor sources, CloudX ILRD, and opted-in external mediator ILRD. Read the docs →
• Config inspection — Added cloudx config show for live configs, published versions, drafts, and config rows addressed by ID, with YAML output by default and JSON output for automation. Read the docs →
• Config history — Added cloudx config history for published config history, creator filtering, recent-change filtering, draft inclusion, and publish-time diff summaries.
• Workflow examples — Updated CLI examples and overview pages with auction, config, JSON, and combined reporting workflows. See examples →

[0.28] - 2026-04-22

CloudX in your terminal

Some questions don’t need a browser. With the new CloudX CLI, your daily numbers are one keystroke away — cloudx report dashboard shows revenue, fill rate, eCPM, and trends right next to your prompt. Filter by country, platform, ad unit, or test traffic the same way you would in the dashboard.

When you need data downstream, switch to --json for structured output or cloudx report export for CSV ready to pipe into a spreadsheet, a notebook, or another tool. Install with brew install cloudx, sign in once, and your reporting workflow follows you wherever you work. Read the docs →