Social Media CLI for Paperclip

Automate social media posting across 30+ platforms. Built for Paperclip's multi-agent orchestration to schedule, publish, and manage your social media presence through coordinated agent teams.

View Docs Paperclip

Please make sure there is always a human in the loop.

Get Started in Seconds

Terminal

# Install the skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# List your connected platforms
postiz integrations:list

# Create your first post
postiz posts:create \
  -c "Hello from Postiz Agent!" \
  -s "2025-01-01T12:00:00Z" \
  -i "your-integration-id"

Built for Automation

🤖

AI Agent Ready

Every command outputs structured JSON. Designed for LLMs and automation pipelines to parse, plan, and execute social media workflows.

🌐

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms from a single CLI.

🧵

Threads & Comments

Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.

📷

Rich Media Support

Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.

📅

Scheduled Posting

Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.

⚙️

Platform-Specific Settings

Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.

How It Works

Discover Integrations

List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.

Discovery

postiz integrations:list

# Get platform settings
postiz integrations:settings <id>

# Fetch platform-specific data
postiz integrations:trigger <id> getFlairs \
  -d '{"subreddit":"programming"}'

Create Posts

Compose posts with content, media, comments, and platform-specific settings. Use simple CLI flags for quick posts or JSON files for complex campaigns.

Post Creation

# Simple post
postiz posts:create \
  -c "Check out our new feature!" \
  -m "screenshot.png" \
  -s "2025-01-15T09:00:00Z" \
  -i "twitter-id,linkedin-id"

# Complex post from JSON
postiz posts:create --json campaign.json

Manage & Analyze

List, filter, and manage your scheduled posts. Track performance with platform and post-level analytics. Build batch workflows to schedule entire content campaigns programmatically.

Management & Analytics

# List scheduled posts
postiz posts:list

# Get platform analytics (last 30 days)
postiz analytics:platform <id> -d 30

# Get analytics for a specific post
postiz analytics:post <post-id> -d 7

# Upload media for reuse
postiz upload video.mp4

One Command, Every Platform

Post to multiple platforms simultaneously, each with their own media and platform-specific settings.

Terminal

# Post to multiple platforms at once
postiz posts:create \
  -c "Launching our new feature today!" \
  -m "banner.png" \
  -s "2025-03-01T09:00:00Z" \
  -i "twitter-id,linkedin-id,facebook-id"

# Post with threaded comments
postiz posts:create \
  -c "Main announcement post" -m "hero.png" \
  -c "First follow-up comment" -m "demo.gif" \
  -c "Links and resources" \
  -s "2025-03-01T09:00:00Z" \
  -i "twitter-id,reddit-id"

# Post with platform-specific settings
postiz posts:create \
  -c "Check out this tutorial" \
  -m "video.mp4" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"New Tutorial","type":"text"}}]}' \
  -i "reddit-id"

# Batch schedule a week of content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day content" \
    -s "2025-03-0${day}T09:00:00Z" \
    -i "twitter-id,linkedin-id"
done

What is Paperclip?

Paperclip is an open-source orchestration framework for building 'zero-human companies' by hiring and managing teams of AI agents. It handles content creation, social media distribution, marketing, and more from a single dashboard — including managing your social media with Postiz.

👥

Agent Teams

Manages teams of AI agents working together. Assign content, scheduling, and review agents to handle your entire social media workflow collaboratively.

📊

Single Dashboard

Monitor all agents and tasks from one unified dashboard. Track content pipelines, scheduling status, and agent performance in real time.

⚙

Orchestration

Chain multi-agent workflows with approval gates and handoffs. Build sophisticated content pipelines where agents collaborate on drafting, reviewing, and publishing.

How Postiz Works with Paperclip

Postiz integrates as a tool in Paperclip's orchestration framework. Once configured, your agent teams can call Postiz commands as part of multi-step workflows — from content creation to cross-platform publishing.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz capabilities to specialized agents
✓Orchestrate multi-step workflows with approval chains
✓Monitor all social media activity from the Paperclip dashboard

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# tool integration and assigns it
# to your agent teams

Orchestrated Social Media

Let Paperclip coordinate your agent teams to handle the entire social media pipeline — from content creation to review to publishing across all your platforms.

📎

Multi-Agent Flow

Coordinated agent teams

Paperclip coordinates multiple agents to handle the complete content lifecycle. The Content Agent drafts, the Review Agent approves, and the Scheduling Agent publishes — all orchestrated automatically.

Paperclip Pipeline

Content Agent: Drafting post about
  our new feature launch...
  -> Generated 3 platform variants

Review Agent: Reviewing drafts...
  -> Twitter variant: Approved
  -> LinkedIn variant: Minor edit applied
  -> Reddit variant: Approved

Scheduling Agent: Publishing via Postiz
  1. Uploading media assets
  2. Scheduling across 3 platforms

  Done! Posts scheduled:
  - X (Twitter): scheduled 9:00 AM
  - LinkedIn: scheduled 9:00 AM
  - Reddit (r/programming): scheduled 9:30 AM

📎

Content Pipelines

Declarative workflow config

Define your content pipeline in a paperclip.yaml file. Assign roles to agents and let Paperclip orchestrate the entire flow from creation to publishing.

paperclip.yaml

pipeline: social_media
schedule: "weekdays 9am"
tools:
  - postiz-agent

roles:
  content_creator:
    task: "Draft platform-specific posts"
    output: drafts/

  reviewer:
    task: "Review and approve drafts"
    requires: content_creator
    approval: true

  publisher:
    task: "Schedule approved posts via Postiz"
    requires: reviewer
    platforms:
      - twitter
      - linkedin
      - reddit

Why Paperclip + Postiz

✓Multi-agent teams — coordinate content, review, and publishing agents
✓Single dashboard — monitor all agents and social media tasks
✓Orchestrated pipelines — chain agent workflows with approval gates
✓Scheduled pipelines — automate recurring content workflows
✓Cross-post to 30+ platforms from coordinated agent teams
✓Open-source — both Paperclip and Postiz are fully open-source

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  paperclip:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

Also Works with Claude Code

Postiz Agent is a CLI tool — it works with any AI agent that can run shell commands, including Claude Code, Anthropic's agentic coding tool.

Claude Code

Anthropic's agentic coding tool

Claude Code reads the SKILL.md file to learn all available Postiz commands. It autonomously discovers your integrations, uploads media, composes posts with platform-specific settings, and schedules content across all your connected platforms.

Claude Code

> Schedule a tweet for tomorrow morning
  announcing our new feature, attach
  the screenshot from ./assets/launch.png

Claude Code will automatically run:
  postiz integrations:list
  postiz upload ./assets/launch.png
  postiz posts:create \
    -c "We just launched..." \
    -m "uploaded-url" \
    -s "2025-03-02T09:00:00Z" \
    -i "twitter-id"

Command Reference

Command	Description
`postiz integrations:list`	List all connected social media accounts
`postiz integrations:settings <id>`	Get platform-specific settings schema
`postiz integrations:trigger <id> <method>`	Trigger platform tools (flairs, playlists, etc.)
`postiz posts:create`	Create and schedule a new post
`postiz posts:list`	List all scheduled and published posts
`postiz posts:delete <id>`	Delete a scheduled post
`postiz analytics:platform <id>`	Get analytics for an integration/channel
`postiz analytics:post <id>`	Get analytics for a specific post
`postiz upload <file>`	Upload media and get a reusable URL