Command-line tool

Meta ads from your terminal.

Q: Is this Meta’s Ads CLI?

No. Meta’s is meta-ads, installed with brew install facebook/fb/meta-ads or pip install meta-ads (Meta’s docs). It needs Python 3.12 or later and a system user access token, and you bring the creative. Greenset’s starts from a store link.

Paste your key once. Point it at your store. It draws the ads, opens the previews and asks only what it can’t read.

Get your key

greenset

$ npm i -g greenset$ greenset loginAPI key (hidden):✓ Signed in to Mossgate Coffee.$ greenset go mossgatecoffee.example✓ Mossgate Coffee · shopify · 38 of 38 products imported✓ 6 ads drawn in 34 s. 6 of 6 images used today.✓ Preview open in your browser.Type the daily budget to start it (25): 25✓ Submitted for review. The ad is in Meta's review.

Recorded from the real tool against a test server. The store is an example.

Milwaukee Bucks concept ad. A twelve-point buck alone at center court in a shaft of light.

Nordstrom concept ad. A muddy car tire in a black gift box with tissue paper.

K-Swiss concept ad. A steward stares at one loud cartoon shoe among hundreds of white tennis shoes in a trophy room.

LA Clippers concept ad. A basketball in a barber chair getting a fade.

Jarritos concept ad. A twelve-story orange soda bottle in a Guadalajara plaza, beside a vendor selling little clay jugs.

UNIQLO concept ad. A melting snowman wearing a thermal top.

Xbox concept ad. An explosion frozen mid-air in a living room while a teenager walks to dinner.

Concepts by our creative team. Not commissioned by the brands shown.

Commands

greenset

greenset go [store]                 The guided path
greenset login | logout | whoami    Your key and your workspace

greenset stores list | add <url>
greenset studio <store>             Draw up to six ads, save the images, open a preview
greenset concepts show | images <id>

greenset drafts list | show <id> | create
greenset launch <draft> --budget <dollars>    Start a draft spending
greenset stop                       Pause every live campaign

greenset campaigns                  Numbers. Not reported shows —, never 0
greenset events [--follow]

greenset guardrails get | set       Tighten limits. Raising one needs the console
greenset webhooks list | add | rm | test | deliveries
greenset mcp add <claude|cursor|vscode|codex>
greenset openapi

greenset <command> --help shows every flag.

In scripts

No terminal needed. Flags answer the questions.

terminal

export GREENSET_API_KEY=...
greenset go yourstore.com --budget 25 --dry-run --no-open
greenset launch drf_0a1b2c3d4e5f --budget 25

Greenset’s CLI or Meta’s

Meta shipped its own Ads CLI on April 29, 2026 (Meta’s announcement). It manages campaigns, ad sets, ads and creatives in the account you already run, from the image you hand it. Greenset’s starts one step earlier: a store link in, ads out. See the comparison.

Questions

Is this Meta’s Ads CLI?

No. Meta’s is meta-ads, installed with brew install facebook/fb/meta-ads or pip install meta-ads (Meta’s docs). It needs Python 3.12 or later and a system user access token, and you bring the creative. Greenset’s starts from a store link.

What does it need?

Node 18 or later, no other dependencies, and a Greenset API key. Once, in the console: your ad account, Facebook page, pixel and ad balance.

Does it work in CI and scripts?

Yes. Everything works with no terminal: flags answer the questions, and a missing one is named instead of asked.

What stops it spending by accident?

It checks everything without spending and starts the ad only when you type the daily budget back. greenset stop pauses every live campaign.

Greenset is not affiliated with Meta. Ads go to Meta’s review, and Meta decides.

One key. Go green.

Get your key