Skip to main content
Back to Vibe Coder Toolkit
Intelligence

Campaigns

Launch demand-gen from the terminal

npx promptreports-cli campaign launch <feature>

Kick off a multi-channel demand-gen campaign directly from the CLI — manual launches, npm-release triggers, and campaign inspection.

campaign is the CLI entry-point into the Demand Gen virtual department on PromptReports.ai. launch creates a new campaign for any feature (or automatically from an npm release with the `npm:<pkg>` shorthand) and queues content generation across email, Twitter, LinkedIn, Reddit, HackerNews, and dev.to. list shows every campaign on your account. show pulls one campaign's metadata — status, channels, created timestamp, trigger type. The CLI talks to /api/campaigns with your PROMPTREPORTS_API_KEY, so everything you launch is visible in the Campaigns dashboard on PromptReports.ai, where the generated drafts go through brand-playbook review before sending.

Prerequisites

  • PROMPTREPORTS_API_KEY in your environment (generate at promptreports.ai/settings/api-keys)
  • A PromptReports.ai account on the free tier or higher

Flags & Options

FlagDescriptionDefault
launch <feature>Start a new campaign — <feature> is a free-form name
launch npm:<pkg>Trigger from an npm release — pulls latest version metadata automatically
listList all campaigns on your account
show <id>Show one campaign by id
--jsonMachine-readable output for scripts or dashboards

Examples

Manual launch

npx promptreports-cli campaign launch "V2 export flow"

Kick off a campaign for a new feature you just shipped.

npm release trigger

npx promptreports-cli campaign launch npm:promptreports-cli

Auto-pull release notes from the latest npm version of a package you own.

List campaigns

npx promptreports-cli campaign list

See every campaign on your account with status and channel mix.

Show one campaign

npx promptreports-cli campaign show cmp_abc123

Drill into a single campaign's metadata and state.

Output

Launch shows campaign id, name, trigger type, and the channels queued for content generation. List shows a table of id, name, status, type. Show prints full campaign metadata.

  ✓ Campaign launched
    id:          cmp_01HV9Z...
    name:        V2 export flow
    type:        announcement
    trigger:     manual
    channels:    email, twitter, linkedin, reddit, hackernews, devto
    status:      draft (content generating in the background)

  Next: review generated drafts at https://promptreports.ai/campaigns/cmp_01HV9Z...

What it reads and writes

Reads

Nothing

Writes

Nothing (read-only)

API calls

  • POST /api/campaigns (launch)
  • GET /api/campaigns (list)
  • GET /api/campaigns/:id (show)

Free vs Pro usage

Free tier

  • Launch manual campaigns from your terminal
  • Wire campaign launches into your release script
  • Inspect campaign state without opening a browser

Pro tier

Upgrade
  • Auto-trigger campaigns on every npm release from CI
  • Channel-specific targeting rules (enterprise-only on LinkedIn, etc.)
  • Team dashboards: see every campaign launched across the team
  • Brand-playbook enforcement on every generated draft

Pro tips

  • Set PROMPTREPORTS_API_KEY in your shell profile so `campaign launch` is always ready
  • Use `npm:<pkg>` after `npm publish` to auto-generate release announcements
  • Always pipe to `--json` when wiring into CI so your build can fail on a bad response
Free to try

Install the whole toolkit.

One command unlocks all 23 tools.