hermes-tweet — Claude Code plugin: X/Twitter research with approval
Adds Hermes Agent tools for public X/Twitter research and for private or state-changing operations that need explicit approval.
/plugin marketplace add wshobson/agents
/plugin install hermes-tweet@claude-code-workflowsWhat hermes-tweet does
The plugin ships four pieces: tweet_explore for local route discovery with no credentials, tweet_read for public read-only X/Twitter routes, and tweet_action for private reads, writes, monitors, webhooks, extractions, draws and media work. A portable hermes-tweet skill carries the workflow guidance and references.
The split matters. Public reads start working as soon as XQUIK_API_KEY is set on the Hermes host. Anything private or state-changing sits behind HERMES_TWEET_ENABLE_ACTIONS, which stays off by default — keep it that way for read-first sessions and flip it to true only for one approved operation.
Install with hermes plugins install Xquik-dev/hermes-tweet --enable. Hermes scans plugins during install and update, so read every warning; a dangerous verdict blocks the install or disables an update. Approval boundaries live in skills/hermes-tweet/references/endpoint-contract.md, and workflow patterns in workflows.md.
What it helps with
- discover available X/Twitter routes without credentials
- read public X/Twitter data from inside the agent
- run a write or private read only after approval
- set up monitors and webhooks for X/Twitter events
- pull media or extracted data as part of a workflow
Example prompts for the agent
- show me which X/Twitter routes are available without a key
- read the public posts matching this query
- enable actions and publish the post after I confirm
How to install hermes-tweet
Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install hermes-tweet@claude-code-workflowsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about hermes-tweet
How do I install hermes-tweet in Claude?
Add the marketplace with /plugin marketplace add wshobson/agents, then install the plugin: /plugin install hermes-tweet@claude-code-workflows.
What does hermes-tweet do?
It adds Hermes Agent tools for public X/Twitter research and approval-gated operations: reads, writes, monitors, webhooks, extractions, draws and media.
What do I need before it works?
An XQUIK_API_KEY on the Hermes runtime host. Private and state-changing operations also need HERMES_TWEET_ENABLE_ACTIONS turned on.
Source text
hermes-tweet · MIT
# Hermes Tweet Hermes Tweet adds Hermes Agent tools for public X/Twitter research and approval-gated private or state-changing operations. ## Disclosure This plugin is submitted by the maintainer of the `hermes-tweet` package and the Xquik API that backs its read and action routes. ## What It Includes - `tweet_explore` for local route discovery without credentials - `tweet_read` for public read-only X/Twitter routes when `XQUIK_API_KEY` is set - `tweet_action` for private reads, writes, monitors, webhooks, extractions, draws, and media operations when action gating is enabled - A portable `hermes-tweet` skill with workflow guidance and references ## Setup ```bash hermes plugins install Xquik-dev/hermes-tweet --enable ``` Hermes scans plugins during installation and updates. Review each warning. A dangerous verdict blocks installation or disables an update. Set the API key on the Hermes runtime host: ```bash export XQUIK_API_KEY="<your-key>" export HERMES_TWEET_ENABLE_ACTIONS="false" ``` Keep `HERMES_TWEET_ENABLE_ACTIONS` false for read-first sessions. Set it to `true` only for an approved private read, write, monitor, webhook, extraction, draw, or media operation. ## Documentation See `skills/hermes-tweet/SKILL.md` for the full portable skill instructions, `skills/hermes-tweet/references/endpoint-contract.md` for approval boundaries, and `skills/hermes-tweet/references/workflows.md` for workflow patterns.
© Xquik · MIT · wshobson/agents
