Hermes Tweet is a Hermes Agent plugin for X/Twitter workflows. It keeps endpoint discovery separate from reads and requires explicit configuration before account data or publishing actions are available.
Install
hermes plugins install Xquik-dev/hermes-tweet --enable
Set XQUIK_API_KEY before using read or action tools. Set
HERMES_TWEET_ENABLE_ACTIONS=true only for projects where publishing actions
are intentionally enabled.
Tool Routes
tweet_explore: discover the bundled X/Twitter endpoint catalog without network access.tweet_read: read public, read-only X/Twitter data from a cataloged GET endpoint whenXQUIK_API_KEYis configured.tweet_action: run private or action-marked GET endpoints, draft, schedule, or publish only whenXQUIK_API_KEYis configured andHERMES_TWEET_ENABLE_ACTIONS=true.
Workflow
- Use
tweet_exploreto find the endpoint that matches the user's request. - Use
tweet_readfor public timelines, profile reads, search, or analytics. - Use
tweet_actionfor connected-account state, private GET endpoints, action-marked endpoints, or publishing after clear user approval. - Report what was read or drafted without exposing private account state.
Safety
- Keep all publishing actions explicit and reviewable.
- Treat private account state as sensitive context.
- Do not enable
tweet_actionfor unattended projects. - Do not store API keys, account data, or drafts in the repository.
Links
- Plugin: https://github.com/Xquik-dev/hermes-tweet
- Hermes Agent: https://github.com/NousResearch/hermes-agent