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, signs you in, installs the Hellyeah skill, and hands the rest of the work to the skill. 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. Run `npx hellyeah install` to fetch and install the CLI onto my PATH.
2. Run `hellyeah auth login` and wait for me to register or log in in the browser.
3. Once I'm logged in, run `hellyeah skills add hellyeah` to install the Hellyeah skill.
4. Load the skill and follow its instructions to launch ads.

That's the whole prompt. The skill carries the workflow: 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 bootstrap. npx hellyeah install runs once. Everything after is bare hellyeah <cmd>.
• You register and log in. The browser opens after step 2. 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

One bootstrap with npx. After this, every command is bare hellyeah <cmd>.

npx hellyeah install

Verify:

hellyeah --help

2. Sign up and log in

hellyeah auth login

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

hellyeah auth whoami

3. Set your business profile

The profile is the brand identity every creative anchors to. All eight fields are required 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 campaigns reserve from 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
hellyeah tracker link <trackerId>

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

6. Generate creatives

Both commands lock to your profile. Brand colors, logos, and business context come from the saved profile.

hellyeah creative generate text --hook curiosity_gap --tone playful
hellyeah creative generate image --hook before_after --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

--end-date is required when --budget-type is total. Drop it and use --budget-type daily to cap spend per day instead.

--yes is the explicit human approval for money to move. The launch is atomic: it snapshots creatives, reserves budget, creates the Google Ads campaign, and returns a campaign id.

8. Watch performance

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

Cancellation stops further spend immediately and schedules a refund of unspent budget after the 48-hour settlement window.