Oppira CLI @oppira/cli

Track rivals, plan the week, publish, without leaving the terminal

One tool for competitor intelligence, strategy, content and paid ads. Over 100 commands in 12 groups, all with JSON-friendly output, so a marketer, a shell script or an AI agent can drive the same workflow.

npm install -g @oppira/cli
Requires Node.js 20+ · macOS, Linux & Windows
oppira — ask@oppira/cli
$
Reading Playbook + Intel for Competitor A ... ▸ Ad spend up ~40% MoM — 12 active Meta ads (from 7)▸ New angle: "onboarding in 20 minutes" in 6 of 9 posts▸ Cut entry pricing 15% on Tue; landing page updated▸ Engagement +23% over 30d, followers +2.1% They're buying attention and racing on speed.Battlecard is 8 days stale — run oppira battlecard regen.
What it does

The full platform, scriptable

Everything you do in the Oppira app is a command, from reading a rival's posts to pausing a live campaign. Pipe it, schedule it, or hand it to an agent.

The AI agent, in your terminal

Ask Oppira anything about your market and watch the answer stream back, grounded in the data you track and your own playbook. Keep the thread going with --conversation.

$ oppira ask "how did my main competitor move this month?"

Competitor intelligence

List and inspect every competitor you track, then read their actual posts across Facebook, Instagram, X and LinkedIn, filtered by window and media type.

$ oppira comp list
$ oppira comp posts Acme --platform linkedin

Months of history, distilled

Monthly digests turn into timelines, head-to-head comparisons, top-performing posts and a read on how a rival's tone has shifted.

$ oppira comp timeline Acme --months 6
$ oppira comp compare Acme Globex

Strategy on demand

Read your living playbook, refresh a single section, accept or reject a pending AI suggestion, and regenerate battlecards the moment the market shifts.

$ oppira playbook refresh-section positioning
$ oppira battlecard regen Acme

Studio, from the shell

Generate a calendar week, draft and schedule posts, upload assets, and answer the comment inbox. quick-post uploads an image, writes the post and publishes it in one run.

$ oppira studio quick-post ./launch.png --body "Shipping today" --now

Your own paid ads

Read performance down to a single ad, then act: pause, resume, change budgets, edit creative, manage audiences. Anything that starts or raises spend needs an explicit --yes.

$ oppira ads performance
$ oppira ads pause 1203... # stops spend

Reports that send themselves

Schedule a recurring email report from a plain-language brief, or generate an artifact on the spot and export it to Markdown, HTML, PDF or PPTX.

$ oppira reports create --prompt "rival ad moves" --frequency WEEKLY
$ oppira artifact export abc123 --format pdf

Built to automate

Add --json to any command for clean, parseable output. Non-zero exit codes make it CI-friendly, oppira ask reads from stdin, and named profiles keep accounts apart.

$ oppira ask "summarize my playbook" --json | jq -r .text
Watch it run

From an empty calendar to published posts

A short walkthrough of the CLI planning your marketing communication, drafting the posts and publishing them to your channels.

How it works

From install to answer, in three commands

Step 1 · Install

Add the CLI

Install globally from npm. Requires Node.js 20 or newer.

npm install -g @oppira/cli
Step 2 · Connect

Point it and sign in

Set the API URL, then log in with your Oppira account.

$oppira config set-url https://api.oppira.com
$oppira auth login
Step 3 · Run

You're in

List what you track and start asking questions.

$oppira comp list

Sign in with your email and password, or run oppira auth key generate for a durable API key that fits CI. One install can hold several profiles, so prod, staging and multiple accounts stay apart.

Copy & run

Real commands, nothing invented

Every one of these works today. Grab one and drop it into your shell.

$oppira ask "summarize my playbook" --json | jq -r .text
$oppira comp add "Globex" --website globex.com --instagram https://instagram.com/globex
$oppira comp posts Acme --platform linkedin --from 2026-06-01
$oppira comp compare Acme Globex --months 6
$oppira insights summary
$oppira battlecard regen Acme
$oppira reports create --prompt "weekly rival ad moves" --frequency WEEKLY --day 1 --hour 8
$oppira ads performance --from 2026-06-01
$oppira studio quick-post ./launch.png --body "Shipping today" --channel linkedin --now
$oppira artifact export <id> --format pdf
Cheat sheet

One tool, every workflow

Twelve command groups for intel, strategy, content, paid ads and automation. Run oppira <group> --help for the full list of any group.

ask
Ask the Oppira AI agent — streamed, reads stdin, resumable
comp
Track & inspect competitors, plus the long view from monthly digests
listshowpoststimelinecomparetop-poststonedigestaddtrack
insights
Insight cards & the weekly summary
listsummarygenerate
alerts
Competitor-activity alerts
listrun
battlecard
Battlecards & their history
showhistoryregen
playbook
Your living strategy, editable
showbootstraprefresh-sectionedit-sectionsuggestions
discover
Find profiles, manage suggestions
profilesjobsuggestions
reports
Scheduled email reports
listcreateupdaterunruns
studio
Plan, draft & publish content
postscreatepublishquick-postcalendar-generateassetscomments
ads
Your own paid ads, read & write
performancecampaignstreepausebudgetad-updateaudiences
artifact
Generate & export reports and decks
creategetexport
auth · config
Sign in, API keys & profiles
loginkeyset-urluse
Who it's for

Marketers and machines, same commands

For marketing & growth teams

Pull competitor moves, insights and battlecards into your morning routine, schedule the weekly report once and forget it, check what your own ads did yesterday, and ask a strategic question without opening the app.

For power users & agents

Script anything with --json and exit codes, pipe oppira ask through your own tools, keep separate accounts on separate profiles, and let automated agents drive the whole intel-to-content workflow.

ProThe CLI comes with Pro, and Pro unlocks all of it — the agent, competitor intelligence, playbook, battlecards, scheduled reports, artifacts, Studio publishing and your own paid ads. ask · comp · insights · alerts · battlecard · playbook · reports · artifact · studio · ads

The package itself is free to install from npm. Signing in needs a Pro account, and Pro also includes MCP access if you would rather query the same data from Claude.

Questions

Good questions, straight answers

The Oppira CLI (@oppira/cli) is the official command-line tool for Oppira. Twelve command groups and over 100 commands cover competitor intelligence, your marketing playbook, battlecards, scheduled email reports, generated artifacts, your own paid ad accounts, Studio publishing and the Oppira AI agent, all with scriptable, JSON-friendly output.

Run npm install -g @oppira/cli. You need Node.js 20 or newer. It works on macOS, Linux and Windows.

Yes. Point the CLI at the API with oppira config set-url https://api.oppira.com, then sign in with oppira auth login using your email and password. For automation and CI, run oppira auth key generate for a durable API key instead.

Pro. The package is free to install from npm, and signing in needs a Pro account, which unlocks every command group: the AI agent, competitor intelligence, playbook, battlecards, scheduled reports, artifacts, Studio publishing and your own paid ads. Pro also includes MCP access, so you can reach the same data from Claude or any MCP client.

Yes. The ads group reads performance down to a single ad and can create campaigns, pause and resume them, change budgets, edit creative and manage custom audiences. Every command that starts or raises spend requires an explicit --yes flag, so nothing spends money by accident.

Yes. The studio group generates a content calendar week, drafts and schedules posts, uploads assets, drafts replies for your comment inbox and publishes to your connected channels. oppira studio quick-post uploads an image, writes the post and publishes it in a single run.

Yes. oppira reports create takes a plain-language brief, a WEEKLY or MONTHLY frequency, a send time and a timezone, and optionally a list of competitors to scope it to. You can list, update, pause, delete, run one on demand and inspect recent runs, all from the CLI.

Yes. Add --json to any command for clean, parseable output, and the CLI returns non-zero exit codes on failure so it fits CI pipelines. oppira ask reads from stdin, and named profiles let one install talk to several accounts or environments.

Oppira CLI

The whole platform, one npm install away

Install the CLI, sign in, and run intel, strategy, content and paid ads from the same prompt.

npm install -g @oppira/cli