x-cli

# 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: ```powershell 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: ```powershell x version skill-router xcli status ``` Post or reply: ```powershell x update "post text" x reply <post-id> "reply text" ``` Read or search: ```powershell x timeline x mentions x status <post-id> x search all "query" x search users "name or handle" ``` Account and social graph actions: ```powershell 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: ```powershell 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: ```powershell $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.