hellyeah ⚡

One command from URL to live Meta ad campaign.

npm install -g hellyeah-cli
hellyeah setup   # configure credentials once
hellyeah auth    # connect your Meta account
hellyeah launch --url https://your-product.com --go

Setup

1. Install

npm install -g hellyeah-cli
hellyeah install-skills                  # install for both Claude Code and Codex
hellyeah install-skills --target codex   # install for Codex only
hellyeah install-skills --target claude  # install for Claude Code only

Installed skill names in Claude Code/Codex:

• hellyeah-wizard
• hellyeah-analyze-ad
• hellyeah-launch-campaign
• hellyeah-report

2. Configure credentials (run once)

If you're using hellyeah inside Codex or Claude Code, the default flow is now host mode:

• configure Meta credentials
• use the host AI session
• do not add OPENAI_API_KEY / ANTHROPIC_API_KEY unless you explicitly want standalone mode

If you're using hellyeah in a plain terminal, use standalone mode and configure an AI provider key.

Option A — paste from .env (fastest):

cat .env | hellyeah setup
# or: hellyeah setup  → choose P → paste block → blank line to finish

Option B — step-by-step wizard:

hellyeah setup  # choose S

Prompts for:

• META_APP_ID — your Meta developer App ID
• META_APP_SECRET — your Meta App secret
• META_PAGE_ID — your Facebook Page ID
• META_ACCESS_TOKEN — optional: paste an existing token to skip hellyeah auth
• META_AD_ACCOUNT_ID — optional: your ad account ID

If you explicitly want standalone mode:

hellyeah setup --mode standalone

That mode additionally asks for:

• OPENAI_API_KEY
• ANTHROPIC_API_KEY

Credentials are stored securely in your OS keychain and loaded automatically on every run — no .env file needed. Re-run hellyeah setup to update any value.

3. Authenticate

hellyeah auth                   # Meta OAuth (opens browser)
# Skip this step if you provided META_ACCESS_TOKEN in setup

Usage

# Verify credentials
hellyeah check-creds

# Analyze product + prepare creative (saves session)
hellyeah analyze --url https://your-product.com
hellyeah analyze --url https://your-product.com --generate-image  # force AI image gen

# Launch from saved session (skips re-analyze)
hellyeah launch --from-session --go

# Full one-shot automation
hellyeah launch --url https://your-product.com --budget 30 --go

# With explicit image creative
hellyeah launch --url https://your-product.com --image ./ad.jpg --go

# Explicit provider (standalone mode)
hellyeah analyze --url https://your-product.com --provider openai
hellyeah analyze --url https://your-product.com --provider anthropic

# View performance report
hellyeah report
hellyeah report --days 30

Requirements

• Node.js 18–22
• Meta Business account + App with ads_management permission
• In Codex / Claude Code: Meta credentials only, host AI is the default path
• In plain terminal mode: at least one AI provider key, OPENAI_API_KEY or ANTHROPIC_API_KEY