Changelog

Notable changes to the Hellyeah CLI (hellyeah on npm).

The format follows Keep a Changelog, and the CLI follows Semantic Versioning. The X-Ray SDK and AIMA ship continuously and aren't versioned here; their docs describe what they do today.

[1.2.0] - 2026-06-30

Research and creative release. Point the CLI at a URL to build your brand profile, generate a finished ad in one command, and launch worldwide without fighting location flags.

Added

• hellyeah profile research <url>: auto-fill your brand profile from a website. It proposes a name, description, colors (each hex shown with a swatch), and logo. In a terminal it loops: y applies, n skips, and any other text is a plain-language instruction to revise the proposal for another round. --yes and --json run it unattended.
• Bare URL shortcut: hellyeah <url> goes straight to profile research.
• hellyeah stripe: connect your own Stripe account via Stripe Connect so revenue from your campaigns is tracked back to them (connect, status, disconnect).
• hellyeah creative workflow: one command runs the creative wizard, then generates the image, the text, and the blended ad together. Pass --hook and --headline to run it non-interactively for agents, no terminal needed.
• Position and font controls when editing creative text, plus an edit-blend command.

Changed

• --location is now optional on campaign launch. Omit it to serve worldwide (Google's default). "Worldwide", "Global", and similar terms now resolve to no geographic restriction instead of being matched to the wrong place.

Fixed

• Blank or whitespace-only --location, --keyword, and --language values are rejected before launch (with a hint to omit the flag for worldwide) instead of being sent to Google as a real target.
• creative generate text --rsa descriptions respect Google's 90-character limit as they are written, so a description is no longer cut mid-phrase or left with a dangling comma.

Beyond the CLI

Shipped alongside this release on the continuous (unversioned) track:

• Customer dashboard. A web view of your campaigns, spend, and website analytics (traffic breakdown, sessions over time, and events) in one place. Campaign cards show creative previews and your brand logo, with timestamps in your local timezone.
• Performance Max, end to end. Performance Max campaigns run with full creation, sync, policy checks, and reporting, including worldwide (no-location) PMax.
• Sharper creatives. Generated ad images render text at exact ad dimensions with a cleaner two-layer compositor, and ad copy stays within Google's limits.

[1.1.0] - 2026-06-12

Visibility release. Money, refunds, environments, and campaign states now explain themselves, and launches can be fully validated before a dollar moves.

Added

• hellyeah doctor: one-command diagnostic covering environment, API reachability, credentials, and the binary you're actually running (path, install method, channel, version), with a copy-pasteable line for bug reports.
• campaign launch --dry-run now validates every launch requirement at once (ad account, creatives, budget, spend caps, and wallet balance) and reports all blockers together with exact top-up math. Exit 0 means the campaign is launchable. Read-only, no confirmation needed.
• Organization awareness in money commands: wallet, campaign launch/cancel, and billing print which organization they act on, and warn before the first risky command when you belong to several organizations.
• Campaigns tell you what you can do next: campaign get and status list the actions available right now (pause / resume / cancel), and a blocked action explains what is available instead.
• Refund visibility end to end: campaign cancel shows the refund amount and when it credits back; wallet balance and wallet transactions show refunds on the way; campaign get and list separate money still held from refunds pending; billing refunds explains an empty list instead of "No refunds found."
• creative generate text --rsa: Google Search headlines written as complete standalone phrases.
• Pre-launch tracker mode: tracker create works before your domain is live, so tracking can be installed ahead of launch.
• auth org rename, and profile update keeps your organization name in sync with your brand profile.
• skills update and skills remove, and skills add auto-detects which AI agent it's running in.
• hellyeah feedback scrubs secrets before anything leaves your machine: environment values, common API key patterns, and credentials in URLs are redacted client-side.
• Campaign list shows the failure reason on failed campaigns.

Fixed

• Promo codes now apply at wallet top-up checkout.
• Login is reliable on headless machines, and network errors are reported distinctly from API errors.
• Creative generation no longer requires saved brand colors, and generated images carry your actual logo.
• hellyeah help works, and running with no arguments prints useful guidance.

[1.0.0] - 2026-06-05

First public release of the CLI on npm. Install once, then run bare hellyeah.

Added

• Native installer for macOS, Linux, and Windows (curl -fsSL https://hellyeah.sh | sh), with npm and npx as alternatives for Node environments. npx hellyeah install puts the binary on your PATH.
• hellyeah auth: browser-based login, logout, and whoami, plus organization management with auth org (list, set, clear, invite, leave).
• hellyeah config status: resolved config and credential state.
• hellyeah profile: research and save the brand profile every campaign and creative anchors to (get, update).
• hellyeah wallet: prepaid balance that funds campaigns (balance, topup via Stripe Checkout, transactions, reservations).
• hellyeah billing refunds: refund status for canceled or failed campaign reservations.
• hellyeah creative: generate brand-locked ad copy and images (generate text sync, generate image async, status, list).
• hellyeah campaign: full lifecycle (launch, list, get, status, pause, resume, cancel).
• hellyeah tracker: provision and link X-Ray trackers (create, list, get, link, unlink, install).
• hellyeah skills: install Hellyeah agent skills into Claude Code, Cursor, Codex, and others (list, add).
• hellyeah feedback: one sink for human notes and structured agent reports.
• A structured output contract. Every command returns a JSON envelope under --json, with stable error.codes, next-action hints for agents, and documented exit codes. Every money field is an integer count of USD cents on the wire.
• Approval gates on money movement. Wallet top-ups and campaign launches always pause for an explicit human "yes". The agent never moves dollars on its own.

Known limitations

• Google Ads only (search and Performance Max). Meta Ads, TikTok Ads, and multi-channel attribution are on the roadmap, not in this release.
• Managed accounts only. Campaigns run on a pool of Google Ads accounts that Hellyeah owns. Bring-your-own-account is not supported yet.

See the FAQ for more on what is and isn't supported today.