FAQ

What does Hellyeah do?

Hellyeah ships paid ads for AI-built apps. There are two ways to drive it:

Developers use the Hellyeah CLI from their coding agent (Claude Code, Cursor, Codex, Replit Agent, Windsurf, v0) to run Google Ads. Add the X-Ray Tracking SDK to send app events and conversions back into Hellyeah.
Non-developers message AIMA on WhatsApp. Describe your business and ads go live.

Both run on one system for campaigns, creatives, billing, and analytics.

Do I need a coding agent to use Hellyeah?

Only for the developer path. The CLI is built for agents first, but you can also message AIMA on WhatsApp instead, with no code and no terminal.

Which ad platforms are supported?

Today: Google Ads (search and Performance Max).

Not yet: Meta Ads, TikTok Ads, multi-channel attribution. These are on the roadmap, not in v1.

Can I use my own Google Ads account?

Not in v1. Hellyeah launches campaigns on a managed pool of accounts that we own. You don't need to set up Google Ads yourself; we handle the account provisioning. If you have specific account-portability needs, get in touch.

How does billing work?

Hellyeah uses a prepaid wallet. You top up via Stripe Checkout (hellyeah wallet topup or the AIMA chat). Campaigns reserve budget against your balance, and unused reservations refund automatically. There's no monthly subscription. You pay for ad spend plus a thin platform fee.

What happens to unused budget when I cancel a campaign?

Reserved-but-unspent budget refunds back to your wallet. Cancellations schedule the refund 48 hours later, after final ad-platform settlement. Check hellyeah billing refunds or your AIMA chat for the status.

Is X-Ray free? Is it separate?

X-Ray is Hellyeah's headless analytics. It's included with every Hellyeah account, with no separate subscription. You can also use X-Ray standalone if you only want analytics without running ads.

Can my coding agent move money without asking me?

No. The CLI requires human approval for every money movement:

Wallet top-ups open Stripe Checkout in your browser, where you confirm the amount.
Campaign launches require --yes and prompt the agent to confirm with the human first.
Daily budget caps stay put. The ad platform enforces them, and the agent can't raise them without asking you.

The agent surfaces what it's about to spend, and you say yes or no.

What data does Hellyeah collect from my website?

If you install X-Ray:

Pageviews, click events, form submits, outbound links, web vitals (autocapture)
Custom events you fire via track()
User identifiers you pass via identify(): emails and phone numbers are SHA-256 hashed before storage, and raw PII is not stored.

If you only use the CLI or AIMA without X-Ray, Hellyeah doesn't see your site traffic. We see the business profile fields you provide and the campaign data you launch, nothing more.

How do creatives stay on-brand?

Every creative locks to your business profile: name, website, industry, tone, value proposition. The agent can iterate on hooks and angles, but it can't generate creatives for a different brand. Update the profile (hellyeah profile update) and creatives shift with it. The lock is the safety rail.

Can I cancel a campaign mid-flight?

Yes. Run hellyeah campaign cancel <id> --yes from the CLI, or say "pause/cancel the campaign" in AIMA. Cancellation stops further ad spend immediately and schedules the refund for unspent budget. Existing impressions and clicks are billed normally.

Why is the CLI "agent-first"?

Because coding agents do most of the work. The CLI returns JSON by default when piped, ships structured errors with next commands the agent can run to recover, and skips interactive prompts in the hot path. Humans get TTY-friendly output when they run the CLI directly. Both share the same commands. See Concepts.