Installation

Open Claude Code and run this command:

/plugin install hermes-tweet@claude-code-plugins-plus

Use --global to install for all projects, or --project for current project only.

What It Does

![CI](https://github.com/Xquik-dev/hermes-tweet/actions/workflows/ci.yml)

![Docs](https://github.com/Xquik-dev/hermes-tweet#readme)

![Ask DeepWiki](https://deepwiki.com/Xquik-dev/hermes-tweet)

![PyPI](https://pypi.org/project/hermes-tweet/)

![piwheels](https://piwheels.org/project/hermes-tweet/)

![Python](https://pypi.org/project/hermes-tweet/)

![PyPI Status](https://pypi.org/project/hermes-tweet/)

![Wheel](https://pypi.org/project/hermes-tweet/#files)

![Downloads](https://pypi.org/project/hermes-tweet/)

![Release](https://github.com/Xquik-dev/hermes-tweet/releases)

![Apify Actor](https://apify.com/xquik/x-tweet-scraper)

![License: MIT](LICENSE)

Native Hermes Agent plugin for

X automation through Xquik.

Hermes Tweet brings X search, account reads, tweet posting, replies, likes,

retweets, follows, DMs, monitors, webhooks, draws, extraction jobs, media, and

trend reads into Hermes as structured tools.

Use it when you need a Hermes Agent Twitter plugin, Hermes X automation, social

media automation for agents, or a native Hermes toolset for X/Twitter.

Skills (2)

hermes-tweet SKILL.md View full skill →

Use Xquik from Hermes Agent for X search, posting, replies, likes, retweets, follows, DMs, monitors, extraction jobs, draws, media, and trends.

Hermes Tweet

Name: hermes-tweet
Author: Xquik

Use Hermes Tweet when the user wants to automate or inspect X through Xquik.

When to Use

Use this skill for Hermes Agent sessions that need X/Twitter data or controlled

X actions through the Hermes Tweet plugin.

Use this skill especially for social listening, launch monitoring, support

triage, creator research, brand research, giveaway audits, community audits,

and controlled publishing workflows.

Use tweet_explore first when the user asks for a capability, endpoint, route,

or Xquik API surface. Use tweet_read only after a read-only endpoint is known.

Use tweet_action only after the user requests a write, private read, monitor,

webhook, extraction job, giveaway draw, or media operation that requires action

permissions.

Permissions and Capabilities

Use tweetexplore, tweetread, and tweet_action only through the enabled

Hermes Tweet toolset.

Network access is limited to catalog-listed Xquik API routes reached by those

tools. Do not create direct HTTP fallbacks.

Shell access is not part of normal operation. Use Hermes CLI commands only for

the install and registry checks listed in Testing.

Local file access is not part of normal operation. Do not write reports,

credentials, logs, screenshots, or cached API payloads unless the user asks

for an explicit export workflow.

Environment access is limited to configuration presence checks for

XQUIKAPIKEY, HERMESTWEETENABLE_ACTIONS, and

HERMESENABLEPROJECT_PLUGINS. Never request or echo their values.

MCP access is not required.

Workflow

Use tweet_explore to find the endpoint.
Use tweet_read for public read-only endpoints.
Use tweet_action only for writes or private reads after stating the exact endpoint and payload.

Decision Rules

IF the task is endpoint discovery, THEN call tweet_explore with a short

query.

IF the endpoint method is GET and the catalog does not mark it as an

action, THEN call tweet_read.

IF the endpoint method is not GET, or the route touches private account

state, THEN call tweet_action only when actions are enabled and the user has

approved the operation.

IF tweet_action is unavailable or disabled, THEN explain that action tools

are intentionally gated by HERMESTWEETENABLE_ACTIONS=true.

IF XQUIKAPIKEY is missing, THEN ask the

hermes-tweet SKILL.md View full skill →

Use Xquik from Hermes Agent for X search, posting, replies, likes, retweets, follows, DMs, monitors, extraction jobs, draws, media, and trends.

Hermes Tweet

Use Hermes Tweet when the user wants to automate or inspect X through Xquik.

When to Use

Use this skill for Hermes Agent sessions that need X/Twitter data or controlled

X actions through the Hermes Tweet plugin.

Use this skill especially for social listening, launch monitoring, support

triage, creator research, brand research, giveaway audits, community audits,

and controlled publishing workflows.

Use tweet_explore first when the user asks for a capability, endpoint, route,

or Xquik API surface. Use tweet_read only after a read-only endpoint is known.

Use tweet_action only after the user requests a write, private read, monitor,

webhook, extraction job, giveaway draw, or media operation that requires action

permissions.

Permissions and Capabilities

Use tweetexplore, tweetread, and tweet_action only through the enabled

Hermes Tweet toolset.

Network access is limited to catalog-listed Xquik API routes reached by those

tools. Do not create direct HTTP fallbacks.

Shell access is not part of normal operation. Use Hermes CLI commands only for

the install and registry checks listed in Testing.

Local file access is not part of normal operation. Do not write reports,

credentials, logs, screenshots, or cached API payloads unless the user asks

for an explicit export workflow.

Environment access is limited to configuration presence checks for

XQUIKAPIKEY, HERMESTWEETENABLE_ACTIONS, and

HERMESENABLEPROJECT_PLUGINS. Never request or echo their values.

MCP access is not required.

Workflow

Use tweet_explore to find the endpoint.
Use tweet_read for public read-only endpoints.
Use tweet_action only for writes or private reads after stating the exact endpoint and payload.

Decision Rules

IF the task is endpoint discovery, THEN call tweet_explore with a short

query.

IF the endpoint method is GET and the catalog does not mark it as an

action, THEN call tweet_read.

IF the endpoint method is not GET, or the route touches private account

state, THEN call tweet_action only when actions are enabled and the user has

approved the operation.

IF tweet_action is unavailable or disabled, THEN explain that action tools

are intentionally gated by HERMESTWEETENABLE_ACTIONS=true.

IF XQUIKAPIKEY is missing, THEN ask the

hermes-tweet

Installation

What It Does

Skills (2)

Hermes Tweet

When to Use

Permissions and Capabilities

Workflow

Decision Rules

Hermes Tweet

When to Use

Permissions and Capabilities

Workflow

Decision Rules

Ready to use hermes-tweet?

Related Plugins

hermes-tweet

Installation

What It Does

Skills (2)

Hermes Tweet

When to Use

Permissions and Capabilities

Workflow

Decision Rules

Hermes Tweet

When to Use

Permissions and Capabilities

Workflow

Decision Rules

Ready to use hermes-tweet?

Related Plugins

fairdb-ops-manager

jeremy-firestore

claude-never-forgets

geepers-agents

sprint

geepers-agents