x-cli

name	x-cli
description	Use when working with sferik/x-cli or the X API from the command line: authorizing X accounts, listing accounts, posting or replying, reading timelines, searching posts or users, streaming X events, managing follows, mutes, blocks, lists, direct messages, trends, places, or diagnosing the local `x` CLI install. Do not use for generic algebra variable "x" or unrelated command-line work.

x-cli Universal Adapter

Source

• Upstream repository: https://github.com/sferik/x-cli
• Local checkout: %USERPROFILE%\.x-cli\x-cli
• Primary command: %USERPROFILE%\.local\bin\x.exe
• Compatibility alias: %USERPROFILE%\.local\bin\x-cli.exe
• Router delegator: skill-router xcli
• X profile config: %USERPROFILE%\.xrc
• Legacy read fallback: %USERPROFILE%\.trc
• Universal stack source registry: %USERPROFILE%\.universal-ai-stack\config\source-integrations.json

Operating Model

Use this as a shared CLI source integration, not as copied skill bodies or a background service. The universal install uses:

• one external source checkout for README-grounded reference,
• one built Rust release on PATH as x,
• a namespaced x-cli skill for routing and workflow instructions,
• compact skill-router wrappers in each AI client.

No MCP bridge is required for normal X API work.

Authentication And Secrets

x-cli supports OAuth 1.0a and OAuth 2.0 and stores account/profile data in ~/.xrc. If ~/.xrc is missing, upstream can read legacy ~/.trc and migrate on write.

Never print, paste, store, or commit:

• ~/.xrc or ~/.trc,
• consumer keys or secrets,
• OAuth access tokens or refresh tokens,
• direct messages, private account data, or private API output.

Start or inspect auth with:

x authorize
x accounts
x set active <account>

Use --profile <FILE> when the user explicitly wants an isolated profile file.

Common Workflows

Check the install:

x version
skill-router xcli status

Post or reply:

x update "post text"
x reply <post-id> "reply text"

Read or search:

x timeline
x mentions
x status <post-id>
x search all "query"
x search users "name or handle"

Account and social graph actions:

x accounts
x follow <screen-name>
x unfollow <screen-name>
x favorite <post-id>
x retweet <post-id>
x mute <screen-name>
x block <screen-name>

Lists, direct messages, trends, and places are available through the upstream command tree. Run command-specific help before using a less common subcommand:

x --help
x search --help
x stream --help
x list --help
x dm --help

Streaming Safety

Streaming commands keep HTTP connections open. For automation and AI-agent sessions, set X_STREAM_MAX_EVENTS unless the user explicitly wants an open-ended stream:

$env:X_STREAM_MAX_EVENTS = "25"
x stream all

Do not start persistent stream loops in the background without an explicit user request and a stop plan.

Router Selection Rules

Prefer this skill only when the task is specifically about x-cli, X API automation, X/Twitter account operations, timelines, posts, search, streams, direct messages, follows, blocks, mutes, lists, trends, places, or local diagnostics for the x command.

Reject this skill for generic "x" wording, algebra, unrelated CLI tooling, or generic social-media writing tasks that do not need the X API.