Quickstart

🤖 Agent path

Give your coding agent one prompt. It runs the install, signs in, drafts the brand profile, generates creatives, and asks you to approve funding and launch. Works with Claude Code, Cursor, Codex, Replit Agent, Windsurf, or v0.

Copy this prompt

Paste the block below into your coding agent. It bootstraps the CLI, installs the Hellyeah skill, and hands the rest of the work to the skill, which signs you in and takes it from there. No custom instructions needed.

Set up Hellyeah and use it to launch a Google Ads campaign for the site I'm currently working on:

1. Install the CLI and skills: on macOS/Linux run `curl -fsSL https://hellyeah.sh/install.sh | sh -s -- --agents -y`; on Windows run `powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://hellyeah.sh/install.ps1 | iex"` and then `hellyeah skills add hellyeah --global --yes`.
2. Confirm `hellyeah --help` works.
3. Load the skill and follow its instructions to launch ads. It signs me in first (a browser opens for me to register or log in), then walks through the rest.

That's the whole prompt. The skill carries the workflow: sign-in, research, creatives, plan, launch, and the two human approvals at funding and launch time. You don't need to spell any of it out.

What to expect

• One install. The installer runs once. Everything after is bare hellyeah <cmd>.
• You register and log in. The skill opens your browser to sign in before it does anything that needs your account. That's where you sign up or sign in.
• Two approvals later. The skill pauses for your "yes" before money moves: once at wallet top-up, once at campaign launch.

🛠 Manual path

Run every command yourself. The CLI walks you through profile, wallet, creative, and launch, with no agent in the middle.

1. Install the CLI

Install once. After this, every command is bare hellyeah <cmd>.

curl -fsSL https://hellyeah.sh | sh

Windows:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://hellyeah.sh/install.ps1 | iex"

The native installer is recommended. If you'd rather install through Node, npm i -g hellyeah@latest and npx hellyeah@latest install both work. See all install options.

Verify:

hellyeah --help

If the installer printed an export PATH=... line because it couldn't update your PATH, run it (or open a new terminal) before verifying.

2. Sign up and log in

First check whether you are already signed in:

hellyeah auth whoami

If that prints your account, you are set. Skip to step 3. Only if it reports you are not signed in, run:

hellyeah auth login

This opens your browser. Authenticate with Google or email. First-time login auto-creates a Hellyeah account.

3. Set your business profile

The profile is the brand identity every creative anchors to. All eight text fields are required before launch. Brand colors and logos are optional for current creative generation, but you can include them to improve creative quality. Some future campaign types may require additional assets before launch.

hellyeah profile update \
  --business-name "Acme" \
  --website-url "https://acme.com" \
  --industry "e-commerce" \
  --description "Acme sells premium widgets to small businesses" \
  --target-audience "Small business owners in the US" \
  --tone "professional, approachable" \
  --value-proposition "High-quality widgets at wholesale prices" \
  --main-goal "Drive online sales"

Check completeness:

hellyeah profile get

4. Fund your wallet

Hellyeah is prepaid, so campaign submissions debit your wallet.

hellyeah wallet topup --amount 50

This opens Stripe Checkout in your browser to charge the amount you passed. --amount is required.

hellyeah wallet balance

5. (Optional) Set up tracking

For conversions in your campaign reports, provision a tracker and install the SDK now. You can skip this and add tracking later.

hellyeah tracker create --domain acme.com --yes

Use hellyeah tracker create --pre-launch --yes instead if you do not have a production domain yet.

Then install the SDK. See Install the SDK for framework snippets.

6. Generate creatives

Both commands lock to your profile. Saved brand colors, logos, and business context come from the saved profile; generation still works if colors or logos are not set.

hellyeah creative generate text --hook curiosity_gap --tone playful
hellyeah creative generate image --hook before_after --reference mercury --size all

Poll image jobs:

hellyeah creative status --job-id <jobId> --watch

7. Launch the campaign

hellyeah campaign launch \
  --name "Q2 Launch" \
  --text-id <text-job-id> \
  --image-id <landscape-job-id> \
  --image-id <square-job-id> \
  --budget 500 \
  --budget-type total \
  --end-date "2026-08-31T00:00:00Z" \
  --keyword "premium widgets" \
  --location "United States" \
  --yes

CLI launch always uses a lifetime total budget, so --end-date is required. --budget-type is optional; if provided, its only accepted value is total.

--yes is the explicit human approval for money to move. Submission snapshots the creatives, records and completes the wallet debit, and returns a funded campaign id in internal review. Ad-account assignment and Google Ads setup happen only after approval.

8. Watch performance

hellyeah campaign status <campaign-id>
hellyeah campaign pause <campaign-id>
hellyeah campaign resume <campaign-id>
hellyeah campaign cancel <campaign-id> --yes

Withdrawing before Google Ads setup refunds the full budget immediately. After setup, cancellation stops further spend and refunds the unspent amount after the 48-hour settlement window.