Automate Reddit with Hermes Agent

Post to multiple subreddits, target specific communities with flairs, choose post types, and cross-post content — all from the command line or through your AI agent.

Setup Guide GitHub

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

Post to Reddit 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 Reddit integration
postiz integrations:list

# Discover available flairs for a subreddit
postiz integrations:trigger <id> getFlairs -d '{"subreddit":"programming"}'

# Create a Reddit post
postiz posts:create \
  -c "Check this out! A great new tool for developers." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Cool tool for automating social media","type":"self","is_flair_required":false}}]}' \
  -i "your-reddit-integration-id"

Reddit-Specific Features

🎯

Subreddit Targeting

Post to one or multiple subreddits simultaneously. Target the exact communities where your content belongs.

📝

Post Types

Create self posts, link posts, image posts, or video posts. Each type is optimized for Reddit's native rendering.

🏷

Flair Support

Automatically discover and apply required flairs for each subreddit. Never have a post rejected for missing flair again.

🔄

Cross-Posting

Share content across multiple subreddits in a single command. Each subreddit gets its own title and flair configuration.

🔗

Link & Media Posts

Share URLs, images, or videos directly. Link posts drive traffic while media posts maximize engagement within Reddit.

📅

Scheduled Posting

Schedule Reddit posts for peak activity times. Hit the front page by posting when your target subreddits are most active.

How It Works

Find Your Reddit Integration

List your connected accounts and grab your Reddit integration ID. You can also discover available flairs for any subreddit before posting.

Discovery

# List all integrations
postiz integrations:list

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

# Get Reddit settings schema
postiz integrations:settings <reddit-id>

# Discover flairs for a subreddit
postiz integrations:trigger <reddit-id> \
  getFlairs -d '{"subreddit":"programming"}'

Choose Your Post Type

Reddit supports multiple post types. Self posts contain text, link posts share URLs, and image/video posts upload media directly. Pick the right type for your content.

Post Types

# Self post (text only)
"type": "self"

# Link post (shares a URL)
"type": "link"
"url": "https://example.com/article"

# Image post
"type": "image"
# Use -m flag with image URL

# Video post
"type": "video"
# Use -m flag with video URL

Create Your Post

Schedule a Reddit post with your content, target subreddit, post type, and flair. You can post to multiple subreddits at once by adding more items to the subreddit array.

Post Creation

postiz posts:create \
  -c "Check this out" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "subreddit": "programming",
          "title": "Cool tool for developers",
          "type": "self",
          "is_flair_required": false
        }
      }
    ]
  }' \
  -i "reddit-id"

Reddit Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "reddit"
`subreddit`	array	Yes	Array of subreddit targets: [{value: {subreddit, title, type, url?, is_flair_required, flair?}}]
`subreddit[].value.subreddit`	string	Yes	Name of the subreddit to post to (without r/ prefix)
`subreddit[].value.title`	string	Yes	Title of the Reddit post
`subreddit[].value.type`	string	Yes	Post type: "self", "link", "image", or "video"
`subreddit[].value.url`	string	No	URL for link-type posts
`subreddit[].value.is_flair_required`	boolean	Yes	Whether the subreddit requires a flair
`subreddit[].value.flair`	object	No	Flair object with id and name (required if is_flair_required is true)
`subreddit[].value.flair.id`	string	No	Flair template ID from the subreddit
`subreddit[].value.flair.name`	string	No	Display name of the flair

Common Configurations

Copy-paste these settings for common Reddit posting scenarios.

Simple Self Post

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "programming",
        "title": "Check out this new open-source tool",
        "type": "self",
        "is_flair_required": false
      }
    }
  ]
}

Link Post with Flair

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "webdev",
        "title": "How we built our scheduling engine",
        "type": "link",
        "url": "https://example.com/blog/scheduling-engine",
        "is_flair_required": true,
        "flair": {
          "id": "abc123",
          "name": "Article"
        }
      }
    }
  ]
}

Cross-Post to Multiple Subreddits

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "programming",
        "title": "New open-source social media tool",
        "type": "self",
        "is_flair_required": false
      }
    },
    {
      "value": {
        "subreddit": "opensource",
        "title": "We just open-sourced our social media scheduler",
        "type": "link",
        "url": "https://github.com/example/project",
        "is_flair_required": false
      }
    }
  ]
}

Image Post

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "dataisbeautiful",
        "title": "Social media engagement trends 2025",
        "type": "image",
        "is_flair_required": true,
        "flair": {
          "id": "def456",
          "name": "OC"
        }
      }
    }
  ]
}

What is Hermes Agent?

Hermes Agent is an open-source AI agent framework by Nous Research — “the agent that grows with you.” It's a flexible platform for building and running AI agents that can execute real-world tasks.

🌱

Grows With You

Hermes Agent learns and adapts to your workflows over time. The more you use it, the better it understands your social media strategy and content style.

🔧

Open-Source Framework

Built by Nous Research, Hermes Agent is fully open-source. Customize and extend it to fit your exact social media automation needs.

⚡

Tool Execution

Hermes Agent can execute CLI tools directly. Install Postiz Agent and Hermes will discover and use all available commands autonomously.

How Postiz Works with Hermes Agent

Hermes Agent discovers Postiz through its tool execution framework. Once Postiz Agent is installed, Hermes reads the available commands and can autonomously manage your social media workflow.

✓Install Postiz Agent globally with npx skills add
✓Hermes Agent discovers Postiz through tool execution framework
✓POSTIZ_API_KEY must be set in environment
✓All Postiz commands become available as agent tools
✓Works with any compatible LLM backend

Install Postiz

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

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Hermes Agent discovers Postiz
# through its tool execution framework
hermes tools list

Reddit Posting with Hermes Agent

Hermes Agent reads Postiz commands through its tool system, discovers your integrations, and handles the entire posting workflow — from content creation to scheduling.

🧠

From Any Chat App

Hermes Agent reads Postiz commands throu...

Send a message to Hermes Agent from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Reddit account via Postiz, finds the right flairs, and schedules the post — all while you go about your day.

Hermes Agent

You: Post to Reddit about our new
  feature launch, schedule for tomorrow
  at 9am

Hermes: I'll handle that! Let me:
  1. Find your Reddit integration
  2. Compose your post content
  3. Schedule for tomorrow 9:00 AM

  Done! Post scheduled successfully.
  Post ID: abc-123

🧠

Scheduled & Proactive

Hermes Agent supports scheduled tas...

Hermes Agent supports cron-based heartbeat tasks. Set up a recurring job that monitors for new content and posts it to the right subreddits automatically — no manual trigger needed.

hermes-config.yaml

scheduled_tasks:
  - name: daily_social_posts
    schedule: "0 9 * * 1-5"
    prompt: |
      Check ~/content/posts for new
      .txt files. For each one, read
      the content and schedule a post
      to Reddit for today at noon.
      Move posted files to
      ~/content/published.

Why Hermes Agent + Postiz for Reddit

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

✓Open-source and fully customizable for your Reddit workflow
✓Grows and adapts to your content strategy over time
✓Tool execution framework discovers Postiz commands automatically
✓Scheduled tasks for hands-free daily posting
✓Cross-post to Reddit + other platforms in a single conversation
✓Works with any LLM backend — not locked to a single provider

SKILL.md (auto-discovered)

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

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz integrations:trigger <id>
    getFlairs -d '{"subreddit":"..."}'
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Reddit Settings
subreddit (array of targets),
type (self/link/image/video),
title, url, flair, is_flair_required

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 Reddit integration, checks flair requirements, and schedules posts to the right subreddits.

Claude Code

> Post to r/programming and r/webdev
  about our new feature, schedule for
  tomorrow morning

Claude will automatically run:
  postiz integrations:list
  postiz integrations:trigger <id> \
    getFlairs -d '{"subreddit":"programming"}'
  postiz posts:create \
    -c "Details about the feature..." \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"subreddit":[
      {"value":{"subreddit":"programming",
        "title":"New feature release",
        "type":"self",
        "is_flair_required":false}},
      {"value":{"subreddit":"webdev",
        "title":"New feature release",
        "type":"self",
        "is_flair_required":false}}
    ]}' \
    -i "reddit-id"

Reddit + Other Platforms

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

Terminal

# Post to Reddit and Twitter simultaneously
postiz posts:create \
  -c "We just launched something awesome! Check it out." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "subreddit": "programming",
          "title": "We just launched our new tool",
          "type": "link",
          "url": "https://example.com",
          "is_flair_required": false
        }
      }
    ]
  }' \
  -i "reddit-id,twitter-id"

# Batch schedule a week of Reddit content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day insights from our dev team" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Dev insight day '$day'","type":"self","is_flair_required":false}}]}' \
    -i "reddit-id"
done

Start posting to Reddit

Install Postiz Agent and automate your Reddit content strategy with AI-powered scheduling and publishing.

Get Started

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Start for $0

Open-source social media scheduling tool

Proudly open-source ❤️