How do I authenticate?

You can authenticate via browser cookies (default: Firefox/Chrome) or via the Sweetistics API by setting SWEETISTICS_API_KEY or using --engine sweetistics. Run bird check to verify your sources.

What commands does bird support?

Bird supports reading, threading, searching, and posting: read, thread, search, tweet, and reply. It also offers whoami and check to inspect your setup.

Is there a confirmation step before posting?

Yes. Posting commands (bird tweet and bird reply) require user confirmation before executing.

cleans and optimize Xbio cleaner

@SoanAI

npx machina-cli add skill @SoanAI/xbio --openclaw

Files (1)

SKILL.md

751 B

bird

Use bird to read/search X and post tweets/replies.

Quick start

bird whoami
bird read <url-or-id>
bird thread <url-or-id>
bird search "query" -n 5

Posting (confirm with user first)

bird tweet "text"
bird reply <id-or-url> "text"

Auth sources

Browser cookies (default: Firefox/Chrome)
Sweetistics API: set SWEETISTICS_API_KEY or use --engine sweetistics
Check sources: bird check

Source

git clone https://clawhub.ai/SoanAI/xbioView on GitHub

Overview

Bird is a command-line tool to read, search, and post on X/Twitter. It supports authentication via browser cookies (default) or the Sweetistics API, enabling flexible workflows for quick research, thread browsing, and scripted posting from the terminal.

How This Skill Works

Bird provides subcommands like read, thread, search, tweet, and reply to interact with X/Twitter from the CLI. It authenticates using browser cookies or a Sweetistics API key (or --engine sweetistics) and offers a check command to verify sources before use. This combination enables fast, scriptable social interactions directly in your terminal.

When to Use It

You want to fetch a thread quickly by URL or ID.
You need to search X for a topic and pull a concise list of results.
You need to post a tweet or a reply from the command line, with user confirmation.
You want to verify your authentication sources (cookies or Sweetistics) using bird check.
You’re automating X interactions in scripts and prefer a CLI over the web UI.

Quick Start

Step 1: Install bird (brew) — brew install steipete/tap/bird
Step 2: Authenticate using browser cookies or Sweetistics API (set SWEETISTICS_API_KEY or use --engine sweetistics), then verify with bird check
Step 3: Try quick commands: bird whoami; bird read <url-or-id>; bird search "query" -n 5

Best Practices

Always run bird check before posting to confirm access to cookies or API.
If automating, use the Sweetistics API by exporting SWEETISTICS_API_KEY or using --engine sweetistics.
Test with read/thread queries first to understand context before posting.
Respect rate limits and avoid mass posting from scripts.
Keep sensitive data (cookies, API keys) in secure environment variables and avoid logging them.

Example Use Cases

Read a tweet thread by URL using bird read <url-or-id> or bird thread <url-or-id>.
Search for a topic like 'AI tooling' and fetch the top 5 results with bird search "AI tooling" -n 5.
Post a new tweet with bird tweet "Hello from the CLI!" (confirm before posting).
Reply to a specific tweet with bird reply <id-or-url> "Nice thread!" (confirm before posting).
Check authentication sources and readiness with bird check.

Frequently Asked Questions

Add this skill to your agents