agentx

An agent-first X / Twitter client in Go.
One binary, one JSON envelope per command — so any agent runtime can drive X.

---

agentx is a from-scratch Go library + CLI built for autonomous agents. Every command prints a single predictable JSON object, supports multiple accounts, and keeps auth_token cookies alive by making traffic look like a real browser.

✨ Why cookies last longer here

X flags/expires auth_token cookies aggressively when traffic doesn't look human. agentx signs every authenticated request with:

• a freshly generated x-client-transaction-id — the exact algorithm x.com's web app runs (golden-tested),
• the full browser header set (bearer, x-csrf-token, x-twitter-*, sec-fetch-*, stable User-Agent),
• the complete cookie string,
• optional uTLS Chrome JA3 fingerprint over HTTP/2 (AGENTX_UTLS=1).

🚀 Quick start

go build -o agentx ./cmd/agentx

# Register an account (cookies from a logged-in browser)
./agentx account add --name main --auth-token <auth_token> --ct0 <ct0>

# Read
./agentx feed -n 20
./agentx user jack
./agentx search --type Latest "golang" -n 20
./agentx analytics <tweet_id>

# Write
./agentx post "hello from agentx 👋"
./agentx reply <id> "nice!" --media pic.jpg
./agentx poll "Tabs or spaces?" --option Tabs --option Spaces

# Grok (AI)
./agentx grok "USD to IDR today?"
./agentx grok image "a majestic dragon" --out dragon.png

Every command prints one JSON envelope:

{ "ok": true,  "schema_version": "1", "data": …, "pagination": {"nextCursor": "…"}, "rateLimit": {…} }
{ "ok": false, "schema_version": "1", "error": {"code": "…", "message": "…"} }

Check .ok, read .data, page with .pagination.nextCursor. Exit code is 0 on success, 1 on a handled error. Output is compact single-line JSON by default (token-efficient for agents) — add --pretty for human-readable output.

🧩 Features

Area	What you get
Read	feed (for-you / following), search, user / posts / tweet / thread / article, media tab, bookmarks (+ folders), likes, followers / following, lists + members, communities, mentions, notifications + unread, trends (+ locations), analytics (engagement rate), retweeters / likers
Write	post, reply, quote, polls (+ vote), like / retweet / bookmark, follow / mute / block, pin, media upload (+ alt text), auto-threads, scheduled tweets, drafts, profile / avatar / banner / settings, topics, list & community management
Grok	text answers with live web search, and image generation (download to file)
DM	classic DM send / list / media / download
Infra	multi-account, zero-auth FxTwitter fallback, uTLS + HTTP/2, rate-limit surfacing, query-id override for X rotations, watch streaming, media download

See SKILL.md for the compact, token-efficient command reference and AGENTS.md for the full agent integration guide.

🏛️ Architecture

cmd/agentx              CLI — one JSON envelope per command
pkg/agent               High-level facade (account selection, client cache, fallbacks)
pkg/xclient             Authenticated x.com GraphQL/REST client (+ transaction signing)
pkg/transaction         x-client-transaction-id generator   [golden-tested]
pkg/account             Multi-account credential store (~/.agentx, 0600)   [tested]
pkg/backends/fxtwitter  Zero-auth single-tweet fallback
pkg/models              Backend-agnostic Tweet / UserProfile / Page
pkg/xerrors             Stable machine-readable error codes

🔌 Use as a Go library

import "github.com/dezxbt/agentx/pkg/agent"

ag := agent.New(store)
page, err := ag.Feed(ctx, "main", false, 20, "")

⚠️ Notes

• Premium-gated (work on X Premium accounts; the client routes correctly and surfaces a clear error otherwise): long-form post (>280), edit, bookmark-folder writes.
• likers are returned by X only to the tweet's author (retweeters is public).
• grok image needs available image-generation quota.
• X's new XChat is end-to-end encrypted and out of scope — keys are device-only and non-extractable by design. Classic DMs work.
• Writes are real and public — confirm intent before acting.

📄 License

MIT — see LICENSE.

---

🔍 Keywords

Twitter API, X API, Twitter CLI, X CLI, Twitter bot, X bot, Twitter automation, X automation, Twitter agent, X agent, Go Twitter client, Golang Twitter, GraphQL Twitter, Twitter scraper, X scraper, Twitter multi-account, cookie auth Twitter, anti-detection Twitter, autonomous agent Twitter, AI agent Twitter, Grok API, Grok CLI, Twitter DM, tweet automation, Twitter search, social media automation, social media bot, Twitter posting, automated tweets, Twitter scheduling, AI-powered Twitter, LLM Twitter, agent framework, Twitter toolkit, X toolkit, headless Twitter, browser automation Twitter, JA3 fingerprint, uTLS Twitter, rate limit Twitter, FxTwitter, x-client-transaction-id, agent skill, AI tool, MCP server, tool use, function calling, agent tool, social media agent skill, Twitter skill, X skill, ChatGPT Twitter plugin, Claude Twitter tool, AI coding agent, agent orchestration, agentic workflow, Hermes agent, LangChain Twitter, AutoGPT Twitter, OpenAI function calling, tool-augmented LLM, RAG social media, prompt engineering Twitter, AI agent toolkit, developer tools, open source agent, self-hosted agent, API wrapper, Twitter API wrapper, X API wrapper, REST API Twitter, GraphQL API Twitter