v0.10.0

What's new

• Single-line installer: Install xcli with one command:

  curl -fsSL https://raw.githubusercontent.com/gupsammy/xcli/main/install.sh | sudo sh

• Platform-aware asset naming: Release binaries now use xcli-{os}-{arch} naming (e.g., xcli-darwin-arm64) to prepare for multi-platform support.
• Polished README: Centered header with badges, one-liner install commands, uninstall section.

Bug fixes

• Bookmarks: Fixed getBookmarkFolders to retry all query IDs before failing on 404.

Full changelog

v0.9.2...v0.10.0

v0.9.2

Added

• bookmark-folders command lists your bookmark folders with IDs, names, and URLs (requires X Premium).
  IDs can be used directly with bookmarks --folder-id.
  Adds BookmarkFolder and BookmarkFoldersResult types to the public API.

xcli bookmark-folders           # human-readable with IDs
xcli bookmark-folders --json    # JSON for scripting
xcli bookmark-folders --json | jq '.[0].id'  # pipe to --folder-id

v0.9.1

Added

• bookmarks (and any paginated command) now prints next-cursor: <value> to stderr in text/human mode, making cursor-based automation scripts easy to write without --json.

# Capture cursor to file while viewing tweets in terminal
xcli bookmarks --all --max-pages 1 --human 2>cursor.txt | less
CURSOR=$(cat cursor.txt | grep next-cursor | cut -d' ' -f2)

Install / upgrade

curl -fsSL https://github.com/gupsammy/xcli/releases/latest/download/xcli -o xcli && chmod +x xcli && sudo mv xcli /usr/local/bin/xcli

v0.9.0 — search flags, sort, markdown output, dual-account routing

What's new in 0.9.0

Search command enhancements

Query operator shortcuts — inject Twitter search operators directly from flags:

• --from <username> — restrict to tweets from a user (from:username)
• --since 1h|3h|12h|1d|7d — time window using precise since_time: Unix timestamp
• --min-likes <n>, --min-retweets <n>, --min-replies <n> — engagement filters
• --no-replies — exclude replies (-filter:replies)
• --quality — shorthand for min_faves:10

Result control:

• --sort recent|top|likes|retweets — recent and top use the API's own product parameter; likes and retweets do client-side sorting
• --pages <n> — fetch N pages (shorthand for --all --max-pages N)
• --limit <n> — cap displayed results after fetch and sort
• --markdown — print results as a research document to stdout
• --save — write results to ~/clawd/drafts/ as a markdown file

Dual-account credential routing

Read-only commands (search, bookmarks, etc.) can now use a separate browser account to avoid rate-limiting your primary write account. Configure in ~/.config/xcli/config.json5:

```json5
{
secondaryCookieSource: "chrome",
secondaryChromeProfile: "Profile 2"
}
```

Install

```bash
curl -fsSL https://github.com/gupsammy/xcli/releases/latest/download/xcli -o xcli
chmod +x xcli
sudo mv xcli /usr/local/bin/xcli
```

xcli v0.8.0

xcli v0.8.0 — Initial public release

xcli is a fast X/Twitter CLI, forked and extended from bird by @steipete (now private).

Features

• Post tweets and replies
• Read tweets, threads, and quote chains
• Bookmarks (with folder support)
• Follow/unfollow, following/followers lists
• Home timeline (For You / Following)
• News and trending topics
• User profile timelines
• Search and mentions
• Engagement: like, retweet, bookmark
• Cookie auth from Safari/Chrome/Firefox — no API key needed
• JSON output (--json) for scripting
• Pagination (--all, --cursor, --max-pages)

Install

```bash
curl -L https://github.com/gupsammy/x-cli/releases/latest/download/xcli -o xcli
chmod +x xcli
sudo mv xcli /usr/local/bin/xcli
xcli --version
```

See CHANGELOG for full history.