Hermes Tweet: X Search, Timelines, Followers & Actions for AI Agents

Add native Xquik tools to Hermes Agent.

Hermes Tweet includes:

• 102 agent-callable Xquik endpoints, generated from OpenAPI.
• 33 prepaid read endpoints, including 7 direct MPP routes.
• Separate read and action tools.
• Actions disabled by default.
• A bundled Hermes Skill and 2 slash commands.

Choose Hermes Tweet

Choose this plugin when Hermes needs catalog-guided Xquik tools. It separates discovery, reads, and confirmed actions. Use an SDK for application code outside Hermes.

Install

Install and enable the plugin:

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

Or install the PyPI package into Hermes:

uv pip install --python ~/.hermes/hermes-agent/venv/bin/python hermes-tweet
hermes plugins enable hermes-tweet

Install a local checkout:

hermes plugins install file:///absolute/path/to/hermes-tweet --force --enable

Configure

Create an API key in Xquik. Then set:

export XQUIK_API_KEY="xq_..."

Optional settings:

export XQUIK_BASE_URL="https://xquik.com"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Restart Hermes after changing environment variables.

Tools

Use tweet_explore first. Then pass a listed /api/v1/... path to the matching tool.

Copied Xquik URLs work when their paths match the catalog.

Common Agent Tasks

Start with tweet_explore. Invoke only the path returned by the catalog.

Set include_actions for extraction, monitoring, and writing searches. tweet_action always follows the approval rules below.

Safety

• Tools never accept credentials as arguments.
• The plugin injects XQUIK_API_KEY at request time.
• Admin, billing, credit, support, guest-wallet, and API-key routes stay hidden.
• Account re-authentication routes stay hidden.
• Binary downloads stay outside the agent catalog. Use REST for those files.
• Private reads and mutations use tweet_action.
• tweet_action requires HERMES_TWEET_ENABLE_ACTIONS=true.

Without an API key, Hermes exposes only tweet_explore.

Slash Commands

Develop

Regenerate the catalog from the canonical OpenAPI schema:

python scripts/build_catalog.py ../xquik/openapi.yaml

Run all checks:

uv run --python 3.12 --group dev ruff format --check .
uv run --python 3.12 --group dev ruff check .
uv run --python 3.12 --group dev basedpyright
uv run --python 3.12 --group dev pytest --cov=hermes_tweet --cov=tests --cov-report=term-missing --cov-fail-under=100
uv run --python 3.12 --group dev bandit -c pyproject.toml -r hermes_tweet scripts fuzz
uv run --python 3.12 --group dev pip-audit
uv run --python 3.12 --group dev bash scripts/check_reproducible.sh
uv run --python 3.12 --group dev python -m build
uv run --python 3.12 --group dev twine check dist/*

Links

• Xquik API reference
• Xquik authentication
• Context7 guide
• Integration patterns
• Hermes surfaces
• Organization support policy
• Security policy
• Contribution guide

License

MIT

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.