agentx

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

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.