Automate Lemmy with Hermes Agent
Post to Lemmy communities, share links across the fediverse, and cross-post to multiple communities — all from the command line or through your AI agent.
Please make sure there is always a human in the loop.
Post to Lemmy 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 Lemmy integration
postiz integrations:list
# Post to a Lemmy community
postiz posts:create \
-c "Check out this interesting article about open source!" \
-s "2025-01-15T10:00:00Z" \
--settings '{"subreddit":[{"value":{"subreddit":"technology","id":"comm-id","title":"Check this out"}}]}' \
-i "your-lemmy-integration-id"Lemmy-Specific Features
Community Posting
Post directly to any Lemmy community. Target specific communities by name and ID for precise content distribution.
Link Posts
Share URLs alongside your post content. Perfect for sharing articles, resources, and external content with your communities.
Federated Network
Reach users across the entire fediverse. Your posts on one Lemmy instance are visible to federated instances automatically.
Cross-Community Posting
Post to multiple Lemmy communities in a single request. Share content across related communities to maximize reach.
Custom Titles
Set unique titles for each community post. Tailor your headlines to match the culture and expectations of each community.
Scheduled Posting
Schedule posts with precise timestamps. Plan your community engagement ahead of time and post at peak activity hours.
How It Works
Find Your Lemmy Integration
List your connected accounts and grab your Lemmy integration ID. You can also fetch available settings to see what options are supported.
Discovery
# List all integrations
postiz integrations:list
# Filter for Lemmy
postiz integrations:list | jq \
'.[] | select(.identifier=="lemmy")'
# Get Lemmy settings schema
postiz integrations:settings <lemmy-id>Choose Your Communities
Identify the Lemmy communities you want to post to. Each community requires a name, ID, and a post title. You can optionally include a URL for link posts.
Configuration
# Example community configuration
# subreddit = community name
# id = community ID from your instance
# title = post title (required, min 2 chars)
# url = optional link URL
echo '{
"subreddit": [
{
"value": {
"subreddit": "technology",
"id": "comm-123",
"title": "Great article on AI",
"url": "https://example.com/article"
}
}
]
}'Create Your Post
Schedule a Lemmy post with your content, target communities, and optional link URL. Posts can target one or multiple communities at once.
Post Creation
postiz posts:create \
-c "Thoughts on the future of open source" \
-s "2025-03-01T09:00:00Z" \
--settings '{
"subreddit": [
{
"value": {
"subreddit": "technology",
"id": "comm-123",
"title": "The Future of Open Source",
"url": "https://example.com/article"
}
}
]
}' \
-i "lemmy-id"Lemmy Settings Reference
Every Lemmy post accepts these platform-specific settings via the --settings flag.
| Field | Type | Description |
|---|---|---|
__type | string | Must be "lemmy" |
subreddit | array | Array of community objects: [{value: {subreddit, id, title, url?}}] |
subreddit[].value.subreddit | string | Community name (min 2 characters) |
subreddit[].value.id | string | Community ID on the Lemmy instance |
subreddit[].value.title | string | Post title (min 2 characters) |
subreddit[].value.url | string | Optional URL for link posts |
Common Configurations
Copy-paste these settings for common Lemmy posting scenarios.
Simple Text Post to One Community
settings.json
{
"subreddit": [
{
"value": {
"subreddit": "technology",
"id": "comm-123",
"title": "Interesting discussion on AI agents"
}
}
]
}Link Post with URL
settings.json
{
"subreddit": [
{
"value": {
"subreddit": "opensource",
"id": "comm-456",
"title": "New open-source social media tool",
"url": "https://github.com/gitroomhq/postiz-app"
}
}
]
}Cross-Post to Multiple Communities
settings.json
{
"subreddit": [
{
"value": {
"subreddit": "technology",
"id": "comm-123",
"title": "AI-powered social media automation"
}
},
{
"value": {
"subreddit": "selfhosted",
"id": "comm-789",
"title": "Self-host your social media scheduler"
}
},
{
"value": {
"subreddit": "opensource",
"id": "comm-456",
"title": "Open-source alternative to Buffer"
}
}
]
}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 listLemmy 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 Lemmy account via Postiz, composes the post, and publishes it to your chosen communities.
Hermes Agent
You: Post to Lemmy about our new
feature launch, schedule for tomorrow
at 9am
Hermes: I'll handle that! Let me:
1. Find your Lemmy integration
2. Compose your post content
3. Schedule for tomorrow 9:00 AM
Done! Post scheduled successfully.
Post ID: abc-123Scheduled & Proactive
Hermes Agent supports scheduled tas...
Hermes Agent supports cron-based heartbeat tasks. Set up a recurring job that checks for new content and cross-posts it to your Lemmy communities 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 Lemmy for today at noon.
Move posted files to
~/content/published.Why Hermes Agent + Postiz for Lemmy
Hermes Agent makes Postiz a natural fit for your Lemmy workflow. The agent discovers all available commands and autonomously chains them together.
- ✓Open-source and fully customizable for your Lemmy 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 Lemmy + 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 Lemmy
metadata:
hermes-agent:
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>
# Lemmy Settings
subreddit (array of communities),
each with: subreddit, id, title, urlAlso 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 Lemmy integration, composes your post with the right community settings, and schedules it.
Claude Code
> Post an article about our new release
to the technology and opensource
communities on Lemmy
Claude will automatically run:
postiz integrations:list
postiz posts:create \
-c "We just launched v2.0!" \
-s "2025-03-02T09:00:00Z" \
--settings '{"subreddit":[
{"value":{"subreddit":"technology",
"id":"comm-123",
"title":"New Release v2.0",
"url":"https://blog.example.com"}},
{"value":{"subreddit":"opensource",
"id":"comm-456",
"title":"Open Source Release v2.0",
"url":"https://blog.example.com"}}
]}' \
-i "lemmy-id"Lemmy + Other Platforms
Schedule the same content to Lemmy and other platforms in a single command. Each platform gets its own settings.
Terminal
# Post to Lemmy and Reddit simultaneously
postiz posts:create \
-c "Check out our new open-source project! #opensource" \
-s "2025-03-01T09:00:00Z" \
--settings '{
"subreddit": [
{
"value": {
"subreddit": "technology",
"id": "comm-123",
"title": "New open-source social media tool"
}
}
]
}' \
-i "lemmy-id,reddit-id"
# Batch schedule a week of Lemmy content
for day in 1 2 3 4 5; do
postiz posts:create \
-c "Day $day community highlight! #fediverse" \
-s "2025-03-0${day}T10:00:00Z" \
--settings '{"subreddit":[{"value":{"subreddit":"technology","id":"comm-123","title":"Day '"$day"' Highlight"}}]}' \
-i "lemmy-id"
doneStart posting to Lemmy
Install Postiz Agent and automate your Lemmy community engagement with AI-powered scheduling and publishing.
Ready to get started?
Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.
Open-source social media scheduling tool
