Automate X with Paperclip

Schedule tweets, control reply permissions, post threads, and publish to X Communities — all from the command line or through your AI agent.

Setup Guide Paperclip

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

Post to X in Seconds

Terminal

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

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your X integration
postiz integrations:list

# Schedule a post on X
postiz posts:create \
  -c "Hello world! #buildinpublic" \
  -s "2025-01-15T09:00:00Z" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "your-x-integration-id"

# Post a thread (multiple -c flags)
postiz posts:create \
  -c "Thread time! Here's what I learned this week..." \
  -c "1/ First, always ship small increments." \
  -c "2/ Second, get feedback early and often." \
  -c "3/ Third, automate everything you can." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "your-x-integration-id"

X-Specific Features

🗣

Reply Controls

Control who can reply to your posts: everyone, people you follow, mentioned users, subscribers, or verified accounts only.

🧵

Thread Support

Create multi-tweet threads by passing multiple -c flags. Each flag becomes a separate tweet in the thread, posted in order.

🏘

Community Posting

Post directly to X Communities by providing a community URL. Reach targeted audiences with relevant content.

✍

Simple Text Posts

Quickly publish text-only tweets with hashtags, mentions, and links. No media upload required for basic posts.

📸

Media Attachments

Attach images or videos to your posts. Upload media through Postiz and include it seamlessly in your scheduled tweets.

📅

Scheduled Posting

Schedule posts with precise timestamps. Queue up a week of content in minutes and let Postiz handle the publishing.

How It Works

Find Your X Integration

List your connected accounts and grab your X integration ID. You can also fetch available settings to see what options are supported.

Discovery

# List all integrations
postiz integrations:list

# Filter for X
postiz integrations:list | jq \
  '.[] | select(.identifier=="x")'

# Get X settings schema
postiz integrations:settings <x-id>

Compose Your Content

Write your tweet or thread. Use multiple -c flags to create threads. Add media with the -m flag after uploading through Postiz.

Compose

# Simple tweet
postiz posts:create \
  -c "Just shipped a new feature!" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "x-id"

# Thread with multiple tweets
postiz posts:create \
  -c "Big announcement incoming..." \
  -c "We just hit 10k users!" \
  -c "Here's what we learned along the way." \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "x-id"

Schedule & Publish

Schedule your post for a specific time or publish immediately. Set reply controls and optionally target an X Community.

Post Creation

postiz posts:create \
  -c "Check out our latest blog post!" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "who_can_reply_post": "everyone",
    "community": "https://x.com/i/communities/123"
  }' \
  -i "x-id"

X Settings Reference

Every X post accepts these platform-specific settings via the --settings flag.

Field	Type	Required	Description
`__type`	string	Yes	Must be "x"
`who_can_reply_post`	string	Yes	Who can reply: everyone, following, mentionedUsers, subscribers, verified
`community`	string	No	X Community URL to post into

Common Configurations

Copy-paste these settings for common X posting scenarios.

Public Post — Everyone Can Reply

settings.json

{
  "who_can_reply_post": "everyone"
}

Followers Only Replies

settings.json

{
  "who_can_reply_post": "following"
}

Community Post with Verified Replies

settings.json

{
  "who_can_reply_post": "verified",
  "community": "https://x.com/i/communities/1234567890"
}

Mentioned Users Only

settings.json

{
  "who_can_reply_post": "mentionedUsers"
}

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, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

Paperclip orchestrates complex multi-agent workflows. Chain content creation, review, approval, and publishing into automated pipelines.

How Postiz Works with Paperclip

Paperclip integrates Postiz as a tool in its agent orchestration framework. Agents in your Paperclip team can call Postiz commands to manage social media workflows end-to-end.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything 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
# its tool integration system
# and assigns it to agent teams

X Posting with Paperclip

Paperclip assigns specialized agents to each step of your social media workflow — content creation, review, scheduling, and publishing — all orchestrated through Postiz.

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Paperclip assigns specialized agents to each step of your social media workflow — content creation, review, scheduling, and publishing — all orchestrated through Postiz.

Paperclip

Content Agent: Drafted a post about
  the feature launch for X.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found X
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Paperclip orchestrates recurring co...

Paperclip orchestrates recurring content pipelines. Set up agent teams that automatically create, review, and publish content on a schedule.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a X post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for X

Paperclip makes Postiz a natural fit for your X workflow. The agent discovers all available commands and autonomously chains them together.

✓Multi-agent teams for quality X content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to X + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including X
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>

# X Settings
who_can_reply_post, community

Also Works with Claude Code

Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your X integration, composes your tweet or thread, applies reply settings, and schedules the post.

Claude Code

> Post a thread about our product launch
  on X, schedule for tomorrow, everyone
  can reply

Claude will automatically run:
  postiz integrations:list
  postiz posts:create \
    -c "Big news! We just launched..." \
    -c "Here's what makes it special..." \
    -c "Try it out today at..." \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"who_can_reply_post":
      "everyone"}' \
    -i "x-id"

X + Other Platforms

Schedule the same content to X and other platforms in a single command. Each platform gets its own settings.

Terminal

# Post to X and LinkedIn simultaneously
postiz posts:create \
  -c "Excited to announce our new feature! #buildinpublic" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{"who_can_reply_post":"everyone"}' \
  -i "x-id,linkedin-id"

# Batch schedule a week of X content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day tip! #dailytips" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"who_can_reply_post":"everyone"}' \
    -i "x-id"
done