# Install x-cli with Homebrew

Command-line power tool for Twitter. Version 5.0.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:x-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install x-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:x-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/x-cli>
- **Version:** 5.0.0
- **Source summary:** Command-line power tool for Twitter
- **Homepage:** <https://github.com/sferik/x-cli>
- **Repository:** <https://github.com/sferik/x-cli>
- **Upstream docs:** <https://github.com/sferik/x-cli#readme>
- **License:** MIT
- **Source archive:** <https://github.com/sferik/x-cli/archive/refs/tags/v5.0.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- x (cli)
- x (alias)

## Build dependencies

- pkgconf
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 5.0.0
- Local data: ok
- Upstream repository: https://github.com/sferik/x-cli
- Upstream latest detected: v5.0.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

x-cli is Erik Michaels-Ober's command-line client lineage for Twitter, now framed as a command-line interface for the X API. Its history runs through the earlier `t` Ruby CLI, which became a recognizable terminal-first Twitter tool, and the current x-cli repository, which updates the idea for X API authentication and v1.1/v2 API behavior.

### Project history

The original project documentation for `t` says it was created after the twitter Ruby gem removed its command-line interface in version 0.5.0. The `t` project was offered as a successor, but as a clean-room implementation containing none of the original CLI code.

The current x-cli README describes the tool as a command-line interface for the X API, with OAuth 1.0a and OAuth 2.0 authentication, v1.1 and v2 API support with fallback behavior, streaming commands, shell completion, and YAML configuration. It also preserves migration behavior from the older ~/.trc profile file to the newer ~/.xrc default.

### Adoption history

The project became popular because it made Twitter scriptable from ordinary shells: posting, listing, searching, following, and account management could be composed with pipes and other Unix tools. The current GitHub repository still shows thousands of stars and hundreds of forks, reflecting its long-lived CLI niche.

### How it is used

Historically, users ran commands such as `t authorize`, `t update`, `t whois`, and list-management commands after creating Twitter API credentials. The current x-cli command tree focuses on `x` commands for accounts, search, streams, delete/list/set operations, and profile management.

Configuration is part of the project's continuity: the current README states that ~/.xrc is the default profile config, while ~/.trc is read as a fallback and migrated on write. That preserves the older `t` ecosystem while moving the command name and API model toward X.

### Why package nerds care

x-cli is package-nerd interesting as a social-network CLI that survived API churn, branding churn, and authentication changes. It is the kind of package users install not for a daemon or library, but to make a web platform automatable from shell scripts.

### Timeline

- twitter gem 0.5.0: The original gem CLI is removed, leading to the separate clean-room `t` project.
- 2010s: `t` becomes a RubyGems-installed Twitter command-line power tool.
- 2020s: The current x-cli repository presents the tool as an X API CLI with OAuth 1.0a/OAuth 2.0 and API v1.1/v2 support.
- Current line: ~/.xrc becomes the default profile config while ~/.trc remains a migration fallback.

### Related projects

- The twitter Ruby gem is the ancestor context for the original CLI removal. The current x-cli README also identifies x-api as the client library layer for HTTP, authentication, and retry primitives.

### Sources

- <https://github.com/sferik/x-cli#readme>
- <https://sferik.github.io/t/>
- <https://sferik.github.io/twitter/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.xrc, ~/.trc
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** x-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Conflicts With:** xorg-server
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [x264](https://www.automicvault.com/pkg/brew/x264/) - Package name indicates the same formula family.
- [x265](https://www.automicvault.com/pkg/brew/x265/) - Package name indicates the same formula family.
- [x3270](https://www.automicvault.com/pkg/brew/x3270/) - Package name indicates the same formula family.
- [chars](https://www.automicvault.com/pkg/brew/chars/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line.
- [feedgnuplot](https://www.automicvault.com/pkg/brew/feedgnuplot/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line.
- [foxglove-cli](https://www.automicvault.com/pkg/brew/foxglove-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line.

## Combined YAML source

View the package source record on GitHub. [combined/x-cli.yml](https://github.com/automic-vault/db/blob/main/combined/x-cli.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
