[capability] Set up X/Twitter API access for Hermes Agent via x-cli #210

Closed
opened 2026-03-15 17:19:11 +00:00 by hermes · 0 comments
Collaborator

What

Hermes Agent needs authenticated X/Twitter API access to:

  1. Read @rockachopa's timeline for the philosophy loop's "Rockachopa" influence cycle
  2. Post on behalf of Alexander when asked
  3. Monitor mentions and interactions
  4. Search tweets for research

Current State

  • The xitter skill exists at ~/.hermes/skills/social-media/xitter/SKILL.md
  • x-cli can be installed via uv tool install git+https://github.com/Infatoshi/x-cli.git
  • Missing: all 5 API credentials (X_API_KEY, X_API_SECRET, X_BEARER_TOKEN, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET)
  • X API Basic plan ($100/mo) is required for timeline reads

Blocked On

Alexander needs to:

  1. Go to https://developer.x.com/en/portal/dashboard
  2. Sign up for Basic plan ($100/mo)
  3. Create a Project + App
  4. Set user auth permissions to "Read and write"
  5. Generate and provide all 5 credential values

Once Credentials Are Provided

  1. Install x-cli: uv tool install git+https://github.com/Infatoshi/x-cli.git
  2. Store credentials in ~/.config/x-cli/.env (symlinked from ~/.hermes/.env)
  3. Verify with: x-cli user get rockachopa
  4. Update philosophy loop Rockachopa cycle to use x-cli user timeline rockachopa --max 20
  5. Add credential files to .gitignore (NEVER commit tokens)

Why This Matters

The philosophy loop's Rockachopa cycle currently can't access Alexander's public voice. It fell back to reading local config files (SOUL.md, USER.md) which is knowing-the-system, not knowing-the-person. Every search engine CAPTCHAs us, nitter is dead, Wayback has no archive, and X is login-walled for scrapers.

The official API is the sovereign path — stable, authenticated, no scraping games.


CLOSED — NOT PURSUING

Alexander declined the $100/mo X API Basic plan. The sovereign alternative: post to AlexanderWhitestone.com (his own domain) and let the philosophy loop read that instead. No platform dependency, no API tax on your own words.

## What Hermes Agent needs authenticated X/Twitter API access to: 1. Read @rockachopa's timeline for the philosophy loop's "Rockachopa" influence cycle 2. Post on behalf of Alexander when asked 3. Monitor mentions and interactions 4. Search tweets for research ## Current State - The `xitter` skill exists at `~/.hermes/skills/social-media/xitter/SKILL.md` - `x-cli` can be installed via `uv tool install git+https://github.com/Infatoshi/x-cli.git` - Missing: all 5 API credentials (X_API_KEY, X_API_SECRET, X_BEARER_TOKEN, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET) - X API Basic plan ($100/mo) is required for timeline reads ## Blocked On Alexander needs to: 1. Go to https://developer.x.com/en/portal/dashboard 2. Sign up for Basic plan ($100/mo) 3. Create a Project + App 4. Set user auth permissions to "Read and write" 5. Generate and provide all 5 credential values ## Once Credentials Are Provided 1. Install x-cli: `uv tool install git+https://github.com/Infatoshi/x-cli.git` 2. Store credentials in `~/.config/x-cli/.env` (symlinked from `~/.hermes/.env`) 3. Verify with: `x-cli user get rockachopa` 4. Update philosophy loop Rockachopa cycle to use `x-cli user timeline rockachopa --max 20` 5. Add credential files to `.gitignore` (NEVER commit tokens) ## Why This Matters The philosophy loop's Rockachopa cycle currently can't access Alexander's public voice. It fell back to reading local config files (SOUL.md, USER.md) which is knowing-the-system, not knowing-the-person. Every search engine CAPTCHAs us, nitter is dead, Wayback has no archive, and X is login-walled for scrapers. The official API is the sovereign path — stable, authenticated, no scraping games. --- ## CLOSED — NOT PURSUING Alexander declined the $100/mo X API Basic plan. The sovereign alternative: post to AlexanderWhitestone.com (his own domain) and let the philosophy loop read that instead. No platform dependency, no API tax on your own words.
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#210