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.
On this page
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
| Flag | Description | Default |
|---|---|---|
| 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 | — |
| list | List all campaigns on your account | — |
| show <id> | Show one campaign by id | — |
| --json | Machine-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-cliAuto-pull release notes from the latest npm version of a package you own.
List campaigns
npx promptreports-cli campaign listSee every campaign on your account with status and channel mix.
Show one campaign
npx promptreports-cli campaign show cmp_abc123Drill 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