Anomalia CLI — Social Media AI Automation CLI, MCP Server & Agent Skill
Automate your social media from the terminal.Anomalia is the social
media AI autopilot that plans, writes, designs and publishes posts, blog articles and SEO/GEO
audits on autopilot. This repository is its command-line client, MCP server
(Model Context Protocol — + HTTP) and agent skill: everything you need to run social
media automation, content generation and approval workflows from a terminal or an AI agent.
AI social autopilot: plan, write, design and publish posts, blog/SEO, news radar and leads.
2026-11-09
ดาว
—
เครื่องมือ
—
อัปไทม์
—
stdio
This repository ships three ways to drive the same product (same OAuth, same API, no static tokens):
What
Who it’s for
CLI
anomalia terminal commands
Humans & scripts
MCP
Model Context Protocol server (stdio + HTTP)
Cursor, Claude, other MCP hosts
Skill
Agent Skill (skills/anomalia/)
Coding agents / skills.sh / npx skills
You need an Anomalia account. This is a client, not a standalone tool: every call talks to
the Anomalia API over HTTPS. Without an account there is nothing to drive.
With the Anomalia CLI you can automate social media posting, approve AI-generated content in one
tap, edit a carousel slide by slide, turn a post into a video, run SEO and GEO audits, and manage
your blog — from the terminal or from an AI agent like Cursor or Claude.
npm install -g anomalia-cli
# or: pnpm add -g anomalia-cli / bun add -g anomalia-cli
anomalia login
Homebrew
brew tap andreabuttarelli/anomalia-cli https://github.com/andreabuttarelli/anomalia-cli
brew install anomalia
anomalia login
Installer (standalone binary) — macOS arm64/x64 and Linux arm64/x64, no Node/Bun required:
curl -sSL https://raw.githubusercontent.com/andreabuttarelli/anomalia-cli/main/scripts/install.sh | bash
anomalia login
Update later with anomalia update, or npm install -g anomalia-cli@latest / brew upgrade anomalia depending on how you installed. More detail: docs/distribute.md.
Quick start
anomalia brands
anomalia dashboard my-brand
anomalia content my-brand --status pending_user
anomalia approve my-brand --all
anomalia seo my-brand
anomalia web my-brand generate --topic "..."
anomalia ads my-brand --remix
anomalia ai my-brand --message "..." --pipe
Every command takes the brand slug as its first argument. anomalia --help lists them all;
anomalia <command> --help details one. Short id prefixes from tables are accepted; ambiguous
prefixes error instead of guessing.
Area
Commands
Posts
content, approve, post <id> [show|edit|regenerate|slide|reorder|video|publish]
If Connect fails with Not an https or loopback URI: cursor://…, your Cursor build is still
using the custom-scheme OAuth callback — use stdio above, update Cursor (loopback
http://localhost:8787/callback), or see docs/mcp.md.
Local stdio: login tool or existing anomalia login → ~/.config/anomalia/session.json
Remote HTTP: Authorization: Bearer <access_token> (401 without it is expected)
3. Agent Skill & plugins
Publishable Agent Skill for Cursor, Claude, skills.sh, and friends:
npx skills add andreabuttarelli/anomalia-cli --skill anomalia
# or
bash scripts/install-skill.sh --project
bun install
bun run cli.ts --help
bun run mcp
bun run mcp:http
bun run typecheck
bun test
bun run build # binary → dist/
bun run build:all # all four targets
bun run vercel-build # MCP bundles under mcp/api/
Releases: push a v* tag → CI typechecks, tests, cross-compiles binaries + .tar.gz +
SHA256SUMS.txt on the GitHub Release, bumps Formula/anomalia.rb,
and publishes anomalia-cli to npm when NPM_TOKEN is set. Details: docs/distribute.md.
Licensed under the GNU Affero General Public License v3.0 or later. You may use, modify
and redistribute it, but derivative works must stay open source under the same license, must keep
the copyright notice, and must state their changes — including when offered to users over a
network.