sferik /x-cli

A command-line power tool for Twitter.

★ 5,598⑂ 399👁 106⑃ 199● 311▤ 0
RubyMITCreated 2011-11-23sferik.github.io/t
+0
日增长
5,598
stars
399
forks
106
watchers
199
prs
311
issues
0
releases

README

x

A command-line interface for the X API.

 Features

- Full command tree with aliases and options
- X API client library (x-api) for HTTP, auth, and retry primitives
- OAuth 1.0a and OAuth 2.0 authentication
- Automatic retry with backoff for transient API errors
- V1.1 and V2 API support with automatic fallback
- Streaming support for filtered and sampled streams
- Column-aligned output formatting
- YAML configuration file support
- Bash completion support

 Status

- Command families: cli, delete, list, search, set, stream
- Local account/profile commands: accounts, set active, delete account, version, ruler
- Stream commands use persistent HTTP streaming:
  - stream all and stream matrix use OAuth2 sample stream
  - stream search, stream users, stream list, and stream timeline use v2 filtered stream rules + stream
- X_STREAM_MAX_EVENTS can be set to limit emitted events (useful for tests/automation)
- Default profile config is ~/.xrc. If ~/.xrc is missing, ~/.trc is used as a read fallback and migrated on write.

 Development

bash
cargo test
cargo run -- version
cargo run -- accounts --profile /path/to/.xrc


 Releasing

Tagging a new v release triggers GitHub Actions to build and publish binaries for:

- Linux (x86_64-unknown-linux-gnu)
- Linux ARM64 (aarch64-unknown-linux-gnu)
- macOS Intel (x86_64-apple-darwin)
- macOS Apple Silicon (aarch64-apple-darwin)
- Windows (x86_64-pc-windows-msvc)
- Windows ARM64 (aarch64-pc-windows-msvc)

Install cargo-release:

bash
cargo install cargo-release --locked


Then tag and push the current Cargo.toml version:

bash
cargo release-tag


Tag messages come from Cargo.toml release metadata (tag-message).

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON