Postemi CLI
Social media scheduling from the command line, or from your AI agent.
Postemi (https://postemi.com) is a social media scheduler, and this is its
command-line tool. It uses the same public API as the web app: what you
schedule here shows up in your Postemi calendar, and what you schedule there
you can see here too.
Channels: 37 platforms and apps, including Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest and Mastodon.
Plan: the CLI, the API and MCP need the Pro plan or higher (Pro, Creator or
Team). Basic has no API access.
SKILL.md is the full command reference, written for AI agents.
Show it to Claude, ChatGPT, Codex, OpenClaw or Hermes and they can use the
whole CLI with no further explanation.
Install
npm install -g postemi
postemi --help
Node.js 18 or newer.
Sign in
postemi auth:login # device flow: opens postemi.com/app/device in the browser
postemi auth:status # checks the credential
postemi auth:logout # deletes the stored credential
You approve the login in the browser while signed in to Postemi, and choose
there which workspace and which channels the key may reach. The CLI stores it
in ~/.postemi/credentials.json (mode 0600).
No account yet? Create one from the terminal:
postemi auth:signup --email [email protected] # e-mails a code, asks for it and for the terms
postemi auth:signup --email [email protected] --code 123456 --accept-terms --workspace-name "Anna's Cafe"
The person must agree to https://postemi.com/terms and
https://postemi.com/privacy first. An account made with postemi auth:signup
has no free trial: next come postemi billing:plans and
postemi billing:subscribe. Signing up at https://postemi.com/app/signup
instead starts a 7-day free trial; then run postemi auth:login.
For a server, CI or an agent without a browser, use an API key from
Settings, Developers in the web app:
export POSTEMI_API_KEY=your_api_key
| Variable | Default | Purpose |
|---|
POSTEMI_API_KEY | none | API key, when you do not use auth:login |
POSTEMI_API_URL | https://api.postemi.com | API base |
POSTEMI_WORKSPACE | none | Workspace id for every command (same as --workspace) |
POSTEMI_TIMEZONE | none | IANA zone for dates written without an offset |
POSTEMI_AUTH_SERVER | https://api.postemi.com | Where auth:login runs the device flow |
POSTEMI_CLIENT_NAME | Postemi CLI | Name shown on the approval page |
Stored credentials from auth:login take precedence over POSTEMI_API_KEY.
Quick start
postemi auth:status
postemi integrations:list # your channels and their ids
postemi config:set timezone Europe/London # once: how to read dates without an offset
IMG=$(postemi upload ./photo.jpg | jq -r '.path')
postemi posts:create -c "Hello from the terminal" -m "$IMG" \
-s "2026-12-31 09:00" -i "<integration-id>"
Results are JSON on stdout; status lines and errors go to stderr, and every
failure exits 1. Run postemi <command> --help for each command.
Agent skills (optional)
The CLI can install its skills into the coding agents on your machine
(Claude Code ~/.claude/skills, Codex ~/.codex/skills or
$CODEX_HOME/skills, Cursor ~/.cursor/skills, Grok Build
~/.grok/skills). The core postemi skill comes with any of them; the other
two are optional:
postemi skills list # core, writing, growth: installed where
postemi skills add writing # ideas, hooks, formatting, templates
postemi skills add growth # niche, cadence, 30-day plan
postemi skills add all --agent claude --yes
postemi skills remove growth
After postemi auth:login on a terminal the CLI asks once whether you want
the writing and the growth skill (default No) and remembers the answers in
~/.postemi/config.json. It never asks when an agent or a script runs it (no
terminal, --json, or CI set); it prints one hint line instead, once.
With several agents found it asks which; --agent and --yes skip that.
More
Plugins for AI agents
This repository also holds the Postemi plugins, in plugins/:
In Claude Code:
claude plugin marketplace add norbertlevente/postemi-agent
claude plugin install postemi@postemi-agent # MCP server
claude plugin install postemi-cli@postemi-agent # CLI skill
The skill on its own (for OpenClaw and other agents) is
skills/postemi/SKILL.md.
Writing and growth skills
Three more skills help the agent write the posts, not only schedule them:
| Skill | What it teaches | In the plugins |
|---|
skills/postemi-writing | post ideas, hooks and headlines, opening lines, formatting, threads, each network's writing rules, a check before publishing | in every main plugin |
skills/postemi-templates | the template and hook library of the Postemi composer, generated from the web app | in every main plugin, with writing |
skills/postemi-growth | choosing networks and a first niche, a 30-day test, reading the numbers, cadence, 30 angles for one topic, repurposing, bios and profile links, a weekly review | optional: its own plugin, plugins/postemi-growth |
claude plugin install postemi-growth@postemi-agent # the optional growth plugin
With the CLI, writing and growth are both optional; see below.
Development
pnpm install
pnpm build # dist/index.js
pnpm test # type check, build, unit tests (test/), scripts/check.mjs (manifests, skill copies, no other-brand text)
node dist/index.js --help
pnpm sync:templates ../postemi/src/lib/app/templates # regenerate skills/postemi-templates/reference from the web app
pnpm sync:skills # copy writing and templates into the main plugins, growth into postemi-growth
Release steps: PUBLISHING.md. Changes: CHANGELOG.md.
License: AGPL-3.0, see LICENSE.
Source: https://github.com/norbertlevente/postemi-agent
