@talocode/x-agent

Open-source X/Twitter growth agent — CLI, SDK, MCP, REST API, and AI agent skill packs.

npm install -g @talocode/x-agent
x-agent auth login --bearer YOUR_X_BEARER_TOKEN

Features

• Search — tweets, users, trends, conversations
• Post — tweets, replies, threads with AI drafting
• Analyze — Phoenix algorithm scoring (19 engagement signals)
• Monitor — watch keywords, accounts, trends
• CLI — full terminal interface
• SDK — XAgentClient for programmatic use
• MCP — 19+ tools for any MCP-compatible agent
• REST API — HTTP server for remote integrations
• Skills — agent skill packs for Claude Code, OpenCode, Cursor

Quick Start

# Install
npm install -g @talocode/x-agent

# Configure X API credentials
x-agent auth login --bearer YOUR_BEARER_TOKEN

# Search tweets
x-agent search tweets "open source AI"

# Draft content
x-agent post draft --topic "building with MCP" --tone educational

# Score against Phoenix algorithm
x-agent analyze score "Your tweet text here"

# Start MCP server
x-agent mcp

# Start REST API
x-agent serve

CLI Reference

Command	Description
auth login	Configure X API credentials
auth status	Check auth status
search tweets	Search tweets by keyword
search users	Search X users
search tweet <id>	Get tweet by ID
profile get	Get user profile
profile tweets	Get user's recent tweets
profile followers	Get user's followers
profile mentions	Get user's mentions
trends	View trending topics
post tweet	Post a tweet
post draft	Generate AI drafts
post reply	Reply to a tweet
post improve	Improve tweet engagement
analyze score	Phoenix algorithm scoring
analyze post	Full AI analysis
watch add	Add a watch target
watch list	List watch targets
watch check	Check watch targets
mcp	Start MCP server
serve	Start REST API server

SDK Usage

import { XAgentClient } from '@talocode/x-agent'

const client = new XAgentClient({
  tokens: { bearerToken: 'YOUR_TOKEN' }
})

const user = await client.getUser('talocode')
const score = client.scoreTweet('Your tweet text')
const drafts = await client.generateDrafts({ topic: 'AI', tone: 'educational' })

MCP Tools

19 tools for AI agents: get_user, search_tweets, post_tweet, score_tweet, generate_drafts, improve_tweet, analyze_post, and more.

REST API

x-agent serve --port 4173
curl http://localhost:4173/v1/health
curl http://localhost:4173/v1/trends
curl -X POST http://localhost:4173/v1/analyze/score -H 'Content-Type: application/json' -d '{"text":"your tweet"}'

Phoenix Algorithm

Scores posts against X's 19 engagement signals (favorite, reply, retweet, dwell, click, etc.) with weighted predictions and actionable recommendations.

Talocode ecosystem

Part of Talocode — open-source workflow layers for builders. Explore sibling projects:

Project	What it is
ScreenLane	Screen-aware voice command layer
Tera	AI chat & assistant
Codra	Local coding agent
GateLane	MCP gateway & agent tool control plane
ContextLane	Context ingestion for persistent agents
MemoryLane	Persistent agent memory
SignalLane	X growth intelligence
ReplyLane	X reply opportunity intelligence
CrawlerLane	Crawler / SEO intelligence
WebDataLane	Web extraction to structured data
SearchLane	Search layer for agents
InvoiceLane	Invoicing tools
GeoLane	Geo intelligence
UgcLane	UGC workflows
OpenSourceLane	Open-source distribution tools
StackLane	Builder stack platform
Tradia	Trading intelligence
Agent Browser	Browser automation for agents
Talocode	Org home & control plane
Skills	Shared agent skills
X Agent	X automation agent (this repo)
LaunchPix	Launch tooling
ForgeCAD	CAD workflows
WorkLane	Work automation
ClipLoop	Clip / video loops

MCP-compatible agents integrate via each product's MCP server where available (Model Context Protocol).

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT