Post to X (Twitter) from Hermes Agent

Hermes Agent can publish and schedule X (Twitter) posts through Postiz. Once the Postiz skill is installed, you message Hermes from Telegram, Discord, Slack, WhatsApp, or the CLI, and it composes the tweet, splits threads into replies, sets who can reply, targets an X Community, and schedules everything for you.

Setup Guide GitHub

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

Last updated: September 2026

Post to X in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Hermes Agent:
> Post a thread about our launch on X,
  schedule it for tomorrow at 9am

Hermes Agent: Done! Your X post is scheduled.

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

Ask for a thread and Hermes Agent splits it into separate tweets, 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 to post to X (Twitter) from Hermes Agent

You describe what you want in plain language and Hermes Agent handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your X Integration

Ask Hermes Agent whether your X account is connected. It also checks which options the platform supports.

Example conversation

> Is my X account connected to Postiz?

Hermes Agent: Yes — your X account is connected
  and ready. Want me to post something?

Compose Your Content

Describe your tweet or thread. Ask for a thread and Hermes Agent splits it into separate tweets; mention an image or video and it uploads it for you.

Example conversation

> Draft an X post about our new
  feature launch

Hermes Agent: Here's a draft for X:
  "We just shipped something big..."
  Want me to add media and schedule it?

Schedule & Publish

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

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Hermes Agent: Done! Scheduled on X for
  tomorrow at 9:00 AM.

X Settings Reference

Mention any of these in plain language and Hermes Agent sets them for you. These are the X options it can apply to any post.

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

Ask Hermes Agent for any of these common X scenarios and it applies the matching settings.

Public Post — Everyone Can Reply

Just ask

> Post it with: Public Post — Everyone Can Reply

Hermes Agent: Got it. Applying:
  who_can_reply_post: everyone

Followers Only Replies

Just ask

> Post it with: Followers Only Replies

Hermes Agent: Got it. Applying:
  who_can_reply_post: following

Community Post with Verified Replies

Just ask

> Post it with: Community Post with Verified Replies

Hermes Agent: Got it. Applying:
  who_can_reply_post: verified
  community: https://x.com/i/communities/1234567890

Mentioned Users Only

Just ask

> Post it with: Mentioned Users Only

Hermes Agent: Got it. Applying:
  who_can_reply_post: mentionedUsers

What is Hermes Agent?

Hermes Agent is an open-source AI agent from Nous Research, released under the MIT license. It runs on your own machine or server, you talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or the CLI, and it executes tools such as the Postiz skill to post to X (Twitter) and other channels. It works with Nous Portal, OpenRouter, OpenAI, or your own model endpoint.

💬

Message From Anywhere

Talk to Hermes from Telegram, Discord, Slack, WhatsApp, Signal, email, or the terminal. Ask for a X (Twitter) post from whichever app you already have open.

⏰

Built-in Cron Scheduler

Create recurring jobs in plain language, such as weekdays at 9am. Hermes drafts and schedules X (Twitter) content through Postiz and reports back to your chat.

🔧

Open Source, Any Model

Hermes Agent is MIT licensed and self-hosted. Run it on Nous Portal, OpenRouter, OpenAI, or your own endpoint, and extend it with MCP servers or skills like Postiz.

How Postiz Works with Hermes Agent

Postiz ships as an agent skill in the agentskills.io SKILL.md format that Hermes Agent reads. The skill documents every Postiz CLI command, the credentials it needs, and the X (Twitter) settings, so Hermes knows how to list your channels, upload media, and create posts without any custom code.

✓Install the Postiz CLI (npm install -g postiz) and add the skill with npx skills add gitroomhq/postiz-agent
✓Hermes loads skills from ~/.hermes/skills and shows them with hermes skills list
✓Authenticate with POSTIZ_API_KEY, or run postiz auth:login for an OAuth device flow
✓Every Postiz command returns JSON, so Hermes can chain discovery, upload, and posting
✓Prefer MCP? Add https://mcp.postiz.com/mcp-oauth-dynamic under mcp_servers in ~/.hermes/config.yaml

Install Postiz

# Install the Postiz CLI and skill
npm install -g postiz
npx skills add gitroomhq/postiz-agent

# Authenticate: API key or OAuth device flow
export POSTIZ_API_KEY=your_api_key
# or: postiz auth:login

# Confirm Hermes can see the skill
hermes skills list

X 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

Telegram, Discord, Slack, WhatsApp, Signal

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

Hermes Agent

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

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

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

🧠

Scheduled & Proactive

Built-in Hermes cron jobs

Hermes Agent has a built-in cron scheduler. Create a recurring job in plain language and Hermes drafts and schedules your X (Twitter) content through Postiz on that schedule, then reports back to whichever chat you use.

Hermes cron job

# From the terminal
hermes cron create "weekdays at 9am" \
  "Check ~/content/x for new posts.
   Upload any media with postiz upload,
   then schedule each one to X
   for noon today via Postiz. Move posted
   files to ~/content/published."

# Or from any chat with Hermes
/cron add "weekdays at 9am" "Schedule
  today's X post via Postiz"

Why Hermes Agent + Postiz for X

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

✓Hermes Agent is MIT licensed and Postiz has a public API, so nothing is locked in
✓Chat-first: ask for a X (Twitter) post from Telegram, Discord, Slack, WhatsApp, or Signal
✓Cron jobs in plain language for hands-free recurring X (Twitter) posts
✓Cross-post to X (Twitter) and other channels in one request, each with its own settings
✓Model-agnostic: run Hermes on Nous Portal, OpenRouter, OpenAI, or your own endpoint
✓Credentials stay in Postiz; Hermes only holds a Postiz API key or OAuth session

SKILL.md (what Hermes reads)

---
name: postiz
description: Postiz is a tool to schedule
  social media and chat posts to 28+
  channels including X
homepage: https://docs.postiz.com/public-api/introduction
---

# Commands Hermes can run
postiz auth:status
postiz integrations:list
postiz integrations:settings <id>
postiz upload <file>
postiz posts:create -i <id> -c "..." -s <iso>
postiz posts:list
postiz analytics:platform <id>

# X settings
who_can_reply_post, community

Using a different agent for X?

Postiz works with any AI agent that can run CLI commands or call MCP tools, and the X (Twitter) settings on this page are the same for every agent. Read the same guide for Claude Code, OpenClaw, Codex. Or see the guide for any AI agent and the Postiz MCP server.

X + Other Platforms

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

Example

> Post "Excited to announce our new feature!" to
  X and LinkedIn tomorrow at 9am, then schedule
  a daily tip on X every weekday at 10am

Hermes Agent: Done! Scheduled:
  - X + LinkedIn: tomorrow 9:00 AM
  - Daily tips on X: Mon-Fri 10:00 AM

Reply Options

Everyone

everyone

Following

following

Mentioned Users

mentionedUsers

Subscribers

subscribers

Verified

verified

What can you ask Hermes Agent to do on X?

You can ask Hermes Agent to create, schedule, cancel, and measure X (Twitter) posts in plain language. These are the kinds of requests it handles through Postiz.

Ask Hermes Agent

> Turn this blog post into a 5-tweet thread on X and schedule it for Tuesday at 9am. Only people I follow can reply.

Hermes drafts five tweets, creates the thread as comments on the first post, applies who_can_reply_post: following, and schedules it.

Ask Hermes Agent

> Post launch.png to X with the caption "We just shipped dark mode" and share it in our X Community.

Hermes uploads the image with postiz upload, attaches the verified URL, and sets the community URL on the X post.

Ask Hermes Agent

> What did my X account do in the last 30 days?

Hermes runs postiz analytics:platform for your X channel and summarizes impressions and engagement.

X rules Hermes Agent has to follow

Postiz validates every X (Twitter) post before it is scheduled, so these limits and required settings decide whether a request succeeds.

▸Standard X accounts are limited to 280 characters per post. Ask Hermes for a thread when your text is longer; each comment becomes the next tweet.
▸who_can_reply_post is required. If you do not mention it, Hermes should default to everyone, so say "followers only" or "verified only" when you want a restriction.
▸Images and videos must be uploaded through postiz upload first. Raw file paths and external URLs are rejected by the publishing pipeline.
▸The community setting takes a full X Community URL, not a name. Copy it from the community page before asking Hermes to post there.

Hermes Agent and X: frequently asked questions

Can Hermes Agent post to X (Twitter)?

Yes. With the Postiz skill installed, Hermes Agent can create, schedule, and delete X posts, build threads, attach images or video, control who can reply, and post into X Communities. You describe the post in plain language from any chat Hermes is connected to, and it runs the Postiz CLI commands for you.

How do I connect my X account to Hermes Agent?

Connect X inside your Postiz dashboard first, then install the Postiz skill in Hermes with npx skills add gitroomhq/postiz-agent and set POSTIZ_API_KEY. Hermes discovers the connected X channel through postiz integrations:list, so you never paste X credentials into the agent. The X login stays in Postiz.

Can Hermes Agent post a thread on X?

Yes. Ask for a thread and Hermes writes the first tweet as the post body and the rest as comments. Postiz publishes each comment as a reply to the previous tweet, which X shows as a thread. You can attach different media to each tweet and add a delay between them.

Does Hermes Agent respect the 280 character limit on X?

Postiz validates the post before it is scheduled, so an over-length tweet is rejected instead of silently truncated. Hermes sees the error and can shorten the text or convert it into a thread. If your account has a longer limit, mention that when you ask.

Can Hermes Agent tweet on a schedule without me asking each time?

Yes. Hermes Agent has a built-in cron scheduler. Run hermes cron create "weekdays at 9am" with a prompt that tells it to schedule the day's tweet via Postiz, or type /cron add in chat. Hermes runs the job unattended and delivers a summary back to Telegram, Discord, or wherever you talk to it.

Is Hermes Agent posting to X free?

Hermes Agent is open source under the MIT license, so the agent itself is free to run. Postiz offers a 7-day free trial, and paid plans start at $29 per month. See the Postiz pricing page for plan limits on channels and team members.