CLI Reference

Your social media,
from the terminal.

The socialscale CLI puts 10 autonomous AI agents and 15+ platforms under a single, scriptable command. Works in any shell, SSH session, or CI pipeline.

$ curl -fsSL https://get.socialscale.zuhabul.com | sh Copy

macOS · Linux · WSL

InstagramX / TwitterLinkedInTikTokYouTubeThreadsBlueskyMastodonPinterestRedditGoogle BusinessSnapchatDiscordTelegramWhatsApp

Installation

Choose your preferred method.

Terminal

$ curl -fsSL https://get.socialscale.zuhabul.com | sh # macOS / Linux

Installs the latest stable binary to /usr/local/bin. Re-run to update.

Terminal

$ cargo install socialscale # requires Rust 1.81+

Builds from source with your local toolchain. Binary lands in ~/.cargo/bin.

Terminal

$ brew tap socialscale/tap

$ brew install socialscale

Updates via brew upgrade socialscale.

Terminal

$ winget install SocialScale.CLI # Windows Package Manager

Or download the .msi installer from the GitHub Releases page.

Quick start — 4 commands to running agents

bash

socialscale connect --platform instagram # OAuth flow opens in your browser

socialscale plan generate --topic "Q2 product launch" --platforms instagram,linkedin # AI generates a 30-day content calendar

socialscale autopilot start --mode copilot # agents draft; you approve each post

socialscale mcp serve # start MCP server for Claude Desktop / Cursor

Live Demo

Watch the CLI in action

Three real workflows — content planning, autonomous mode, ad reporting.

Autonomy modes

Choose how much control you hand to the agents. Switch modes any time with autopilot start --mode <mode>.

Copilot

--mode copilot

Agents draft and schedule; you approve each post before publish.

Autopilot

--mode autopilot

Agents publish autonomously within your brand guidelines. You review a daily digest.

Full

--mode full

Complete autonomy — agents handle content, ads, replies, and budget optimisation with no approval gates.

Command reference

All commands grouped by category. Run any command with --help for full options.

✦

Content

Create, draft, and schedule posts across platforms.

socialscale draft

Draft a post for one or more platforms with AI assistance.

socialscale plan generate

Generate a full content calendar from a topic and timeframe.

socialscale publish

Publish a post immediately or schedule it.

socialscale hashtags

Suggest trending and relevant hashtags for a topic.

⚡

Automation

Run agents, manage autonomy modes, and control scheduling.

socialscale autopilot start --mode <mode>

Start autonomous mode (copilot / autopilot / full).

socialscale autopilot stop

Gracefully stop all running agents.

socialscale autopilot status

Show live agent status, current tasks, and queue depth.

socialscale experiments

A/B test content variants and measure engagement.

◈

Analytics & Ads

Track performance, manage ad spend, and export data.

socialscale ads report --range 7d

Ad performance report — spend, ROAS, CPA, impressions.

socialscale ads report --format table

Render the report as a terminal table.

socialscale metrics

Engagement metrics across all connected platforms.

socialscale brand

Manage your brand voice, tone guidelines, and assets.

◆

Integrations

Connect platforms, start the MCP server, and manage plugins.

socialscale connect --platform <name>

OAuth connect a social platform (instagram, x, linkedin…).

socialscale mcp serve

Start the MCP server — 22 tools, 10 resources for Claude/Cursor.

socialscale plugin install <name>

Install a WASM plugin from the marketplace.

socialscale plugin list

List installed plugins with version and status.

⊕

System

Update, configure, and manage your SocialScale installation.

socialscale self-update

Update the CLI to the latest stable release.

socialscale --version

Print version information.

socialscale --help

Show help for any command.

socialscale completions <shell>

Output shell completion script (bash / zsh / fish).

Shell completions

Tab-complete commands, flags, and platform names in any supported shell.

bash

socialscale completions bash >> ~/.bashrc && source ~/.bashrc

zsh

socialscale completions zsh >> ~/.zshrc && source ~/.zshrc

fish

socialscale completions fish > ~/.config/fish/completions/socialscale.fish

MCP Server

Use SocialScale inside Claude Desktop & Cursor

Start the MCP server and connect it to any MCP-compatible AI assistant. You get 22 tools and 10 resources — draft posts, check metrics, manage agents, and more without leaving your AI chat.

22 tools

draft_post, publish_post, get_metrics, list_agents, run_agent, schedule_post, search_trends, manage_ads…

10 resources

brand_voice, content_calendar, platform_status, active_campaigns, audience_insights…

1. Start the server

Terminal

$ socialscale mcp serve

✓ MCP server listening on stdio · 22 tools ready

2. Add to claude_desktop_config.json

claude_desktop_config.json JSON

{
  "mcpServers": {
    "socialscale": {
      "command": "socialscale",
      "args": ["mcp", "serve"]
    }
  }
}

CI/CD integration

Publish posts, trigger agents, and run reports as part of any pipeline. Works anywhere the CLI binary runs — GitHub Actions, GitLab CI, CircleCI, Buildkite, Docker.

GitHub Actions

.github/workflows/publish.yml

- name: Publish release announcement
  run: |
    socialscale publish \
      --content release-notes.md \
      --platforms linkedin,x,bluesky \
      --schedule now
  env:
    SOCIALSCALE_API_KEY: ${{ secrets.SS_KEY }}

Docker

Dockerfile / docker run

# Run any CLI command in a container
docker run --rm \
  -e SOCIALSCALE_API_KEY=${SS_KEY} \
  -v $(pwd)/content:/content \
  ghcr.io/socialscale/cli \
  plan generate \
  --topic "product launch" \
  --output /content/plan.json

Environment variables

Variable	Description
`SOCIALSCALE_API_KEY`	API key for managed cloud authentication.
`SOCIALSCALE_CONFIG_DIR`	Override the default config directory (~/.config/socialscale).
`SOCIALSCALE_LOG_LEVEL`	Log verbosity: error \| warn \| info \| debug \| trace.
`SOCIALSCALE_NO_COLOR`	Disable ANSI colour output (also respects NO_COLOR standard).
`ANTHROPIC_API_KEY`	Anthropic API key used by the AI agents.
`OPENAI_API_KEY`	OpenAI API key (optional fallback LLM).

WASM Plugins

Extend with WASM plugins

SocialScale runs plugins inside a Wasmtime sandbox — safe, isolated, blazing fast. Write in Rust, Go, C, or AssemblyScript and publish to the marketplace with a single command.

Rust, Go, C, AssemblyScript support
Wasmtime 26 runtime — sandboxed by default
Access 22 MCP tools from plugin code
Publish with `socialscale plugin publish`
Auto-update via `socialscale plugin update`

Plugin commands

$ socialscale plugin list # list installed

$ socialscale plugin install <name> # from marketplace

$ socialscale plugin update # update all

$ socialscale plugin remove <name> # uninstall

$ socialscale plugin publish # push to registry

Ready to automate?

Install the CLI, connect your first platform, and have agents running in under five minutes.

$ curl -fsSL https://get.socialscale.zuhabul.com | sh

View pricing → GitHub → Full commands →

Your social media, from the terminal.

Installation

Quick start — 4 commands to running agents

Watch the CLI in action

Autonomy modes

Command reference

Shell completions

Use SocialScale inside Claude Desktop & Cursor

CI/CD integration

Extend with WASM plugins

Ready to automate?

Your social media,
from the terminal.