Hermes Tweet: plugin for Hermes Agent

Hermes Agent plugin for X (Twitter) search, monitoring, follower exports and approval-gated actions

What Hermes Tweet does

The plugin gives Hermes access to a catalog of 102 OpenAPI-generated Xquik endpoints, including 33 prepaid reads and 7 direct MPP routes. It registers three tools: tweet_explore searches the bundled catalog and makes no API call, tweet_read calls read endpoints, and tweet_action handles private or mutating endpoints such as posting, monitors and follower extractions. It also bundles a Hermes Skill and two slash commands, /xstatus for account and usage status and /xtrends for current X trends.

Actions are off by default and require HERMES_TWEET_ENABLE_ACTIONS=true. Tools never accept credentials as arguments, because the plugin injects XQUIK_API_KEY at request time, and admin, billing and API-key routes stay hidden. Without an API key, only tweet_explore is exposed. Xquik is an independent third-party service not affiliated with X Corp, and the plugin is MIT licensed.

Key features

Three tools for exploring, reading and acting, kept separate
Catalog of 102 OpenAPI-generated Xquik endpoints
Actions disabled by default behind an environment variable
Bundled Hermes Skill plus /xstatus and /xtrends slash commands
Credentials injected at request time, never passed as tool arguments

When to use it

Searching X posts or reading a profile timeline from a Hermes conversation
Setting up an account monitor or a follower export
Posting or replying only after explicitly enabling actions

Who it is for: Hermes Agent users who want their agent to search, monitor or act on X through the Xquik API.

How it fits with Hermes Agent

Built for Hermes Agent as an installable plugin that registers tools, a skill and slash commands.

How to install Hermes Tweet

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

hermes plugins install Xquik-dev/hermes-tweet --enable

Requirements: An Xquik API key set as XQUIK_API_KEY

Note: Requires an Xquik API key, and the README refers to prepaid reads, so usage may be billed by Xquik, a third-party service not affiliated with X Corp.

FAQ

What is Hermes Tweet?

Hermes Tweet is a Hermes Agent plugin that connects the agent to the Xquik API for X (Twitter) search, reading, monitoring, follower exports and approved actions.

How do I install Hermes Tweet?

Run hermes plugins install Xquik-dev/hermes-tweet --enable, then set XQUIK_API_KEY and restart Hermes. The README notes that Hermes scans plugins during install and update, and a dangerous verdict blocks the install.

What can Hermes Tweet do without an API key?

Without an API key, Hermes exposes only tweet_explore, which searches the bundled endpoint catalog and makes no API call. Reads and actions need XQUIK_API_KEY.