# Social Media CLI for Codex

Automate social media posting across 30+ platforms. Built for OpenAI Codex to schedule, publish, and manage your social media presence directly from the CLI and your IDE.

[View Docs](https://github.com/gitroomhq/postiz-agent) [GitHub](https://github.com/openai/codex) npx skills add gitroomhq/postiz-agent

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

# Use Codex to interact with Postiz
codex "list my social media integrations"

# Create your first post
codex "post 'Hello from Postiz Agent!' to Twitter, schedule for tomorrow at 9am"
```

## 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

1

#### 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"}'
```

2

#### 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
```

3

#### 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 Codex?

Codex is OpenAI's autonomous coding agent. It runs in your terminal and IDE, executes shell commands in a sandboxed environment, and completes multi-step tasks autonomously — including managing your social media with Postiz.

💻

#### CLI & IDE Native

Codex runs directly in your terminal or IDE. No browser or cloud setup needed — just run codex from the command line to manage your social media workflow.

🔧

#### Autonomous Execution

Codex executes shell commands in a sandboxed environment. It reads SKILL.md, discovers Postiz commands, and chains them together for complex workflows.

⚡

#### Parallel Tasks

Run multiple Codex sessions in parallel. Schedule posts on one terminal while analyzing metrics on another — each task runs independently and concurrently.