Social Media CLI for Perplexity Computer

Automate social media posting across 30+ platforms. Built for Perplexity Computer to decompose campaigns into subtasks, spawn sub-agents, and deliver finished results across all your social channels.

View Docs

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 Perplexity Computer?

Perplexity Computer is a general-purpose digital worker that decomposes high-level goals into subtasks, spawns specialized sub-agents across 19 AI models, and delivers finished results — from code to marketing campaigns to social media content.

🧩

Task Decomposition

Perplexity Computer breaks complex social media campaigns into individual subtasks — content creation, image generation, scheduling, and cross-posting — then executes each one.

🔄

Multi-Model

Spawns sub-agents across 19 different AI models, selecting the best model for each subtask — writing, image analysis, scheduling optimization, and more.

🎯

End-to-End Delivery

From ideation to publishing, Perplexity Computer handles the entire workflow. Give it a goal and it delivers finished, published social media content.

How Postiz Works with Perplexity Computer

Perplexity Computer discovers Postiz through tool integration. Once configured, it decomposes your social media goals into subtasks and spawns sub-agents that call Postiz commands directly.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Perplexity Computer discovers Postiz through tool integration
✓Tasks are decomposed and distributed across sub-agents
✓Best model is selected for each subtask automatically
✓End-to-end verification ensures posts are published correctly

Install Postiz

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

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Perplexity Computer discovers Postiz
# through tool integration
# and decomposes tasks across sub-agents

Post With Perplexity Computer

Tell Perplexity Computer your campaign goal — it decomposes it into subtasks, spawns sub-agents for each step, and delivers published posts across all your platforms.

🌐

Campaign Decomposition

Goal to subtasks automatically

Tell Perplexity Computer your campaign goal. It decomposes the work into subtasks, assigns each to the best AI model, and delivers finished posts across all your platforms.

Perplexity Computer

You: Run a week-long product launch
  campaign across Twitter, LinkedIn,
  and Reddit with daily posts, each
  with unique angles and visuals.

Perplexity Computer: Decomposing task...
  Subtask 1: Research product angles
  Subtask 2: Generate 5 unique posts
  Subtask 3: Create visual assets
  Subtask 4: Schedule Mon-Fri via Postiz
  Subtask 5: Verify all posts queued

  Done! 5 posts scheduled:
  - Mon: Product intro (3 platforms)
  - Tue: Feature deep-dive (3 platforms)
  - Wed: Customer story (3 platforms)
  - Thu: Behind the scenes (3 platforms)
  - Fri: Launch CTA (3 platforms)

🌐

Recurring Campaigns

Ongoing multi-model automation

Perplexity Computer can manage recurring campaigns by decomposing each cycle into subtasks, selecting the best model for content generation, and scheduling via Postiz.

Perplexity Computer Task

Tell Perplexity Computer:

"Every Monday, research trending topics
in our industry, generate 5 social
media posts with unique angles, create
matching visuals, and schedule them
across all platforms for the week."

Perplexity Computer will decompose:
  1. Research trends (search model)
  2. Generate copy (writing model)
  3. Create visuals (image model)
  4. Schedule via Postiz (tool agent)
  5. Verify delivery (validation agent)

Why Perplexity Computer + Postiz

✓Task decomposition — breaks campaigns into optimized subtasks
✓19 AI models — selects the best model for each subtask
✓End-to-end delivery — from ideation to published posts
✓Research-powered — leverages Perplexity's search for trending content
✓Cross-post to multiple platforms in a single campaign goal
✓Available to Perplexity Max subscribers

SKILL.md (auto-discovered)

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

Agentic coding tool by Anthropic

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