@posteverywhere/cli

@posteverywhere/cli

Post and schedule to Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram and Discord — all from your terminal. Log in once, connect accounts, publish. Built for humans and AI agents (--json output for Claude, Cursor, etc.).

Install

npm install -g @posteverywhere/cli
# …or run without installing:
npx @posteverywhere/cli <command>

90-second setup

posteverywhere login                 # opens your browser, saves a key to ~/.posteverywhere
posteverywhere connect instagram     # opens the OAuth flow; auto-detects the connected account
posteverywhere accounts              # list connected accounts (+ ids & health)
posteverywhere post -c "Hello 🚀" -a 123,456

login uses a device-grant flow (like the GitHub CLI): it prints a short code, you approve it in the browser, and a scoped API key is saved locally (chmod 600). Manage or revoke it anytime from Settings → Developers.

Connecting accounts

posteverywhere connect <platform>

• Browser platforms (instagram, facebook, threads, x, linkedin, tiktok, youtube, pinterest): opens the normal OAuth flow in your browser, then auto-detects the new account.
• Bluesky: prompts for your handle + an App Password (Settings → App Passwords).
• Telegram: prompts for a bot token (@BotFather) + your channel — add the bot as an admin first.
• Discord: prompts for a channel webhook URL (Server Settings → Integrations → Webhooks).

Re-authorize an expired account: posteverywhere reconnect <accountId>.

Commands

Command	What it does
login / logout	Device-flow login / remove saved credentials
whoami	Show the authed account, plan & quota
accounts	List connected accounts (+ ids & health)
connect <platform>	Connect a new account
reconnect <accountId>	Re-authorize an account whose token expired
account:health <id>	Detailed health for one account
post -c <text> -a <ids> [-s <iso>] [-m <mediaIds>]	Publish now (omit -s) or schedule (-s ISO time)
posts [--status x] [--platform y] [--limit n]	List posts
results <postId>	Per-platform publish results
retry <postId>	Retry failed destinations
upload <imageUrl>	Import an image by URL → media_id
caption -t <topic> [--platform x] [--tone y]	AI captions
analytics [--period week|month|all]	Analytics summary
campaigns	List campaigns

For AI agents

Every command accepts --json (auto-on when piped) and emits structured JSON. This package ships a SKILL.md for agent auto-discovery — point Claude/Cursor/etc. at it. Prefer MCP? Use the hosted endpoint https://mcp.posteverywhere.ai/mcp or npx -y @posteverywhere/mcp.

Auth precedence

• POSTEVERYWHERE_API_KEY env var (great for CI / agents)
• the key saved by posteverywhere login (~/.posteverywhere/config.json)

Your key authenticates into your PostEverywhere account and acts only through it — the CLI never touches your social-platform credentials directly. Keep a human in the loop before publishing.

Docs: https://developers.posteverywhere.ai/cli