Setup & Installation
openclaw skills install @soanai/xbio
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install xbio
What This Skill Does
bird is a CLI for reading, searching, and posting on X (formerly Twitter). It authenticates via browser cookies from Firefox or Chrome, or via the Sweetistics API as an alternative engine.
Uses existing browser cookies for auth, so no official X API credentials or developer account are needed by default.
When to use it
- Reading a tweet or full thread by URL from the terminal
- Searching X for recent posts on a specific topic
- Posting a tweet without opening a browser
- Replying to a tweet by ID or URL
- Checking which auth sources are active before posting
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Search for tweets about 'claude ai' and reply to the top result
AGENT
- 1Run `bird search "claude ai" -n 5` to retrieve recent matching tweets
- 2Select the top result and note its tweet ID or URL
- 3Run `bird read <id>` to review the full tweet content
- 4Confirm reply text with the user before posting
- 5Run `bird reply <id> "reply text"` to post the reply
OUTPUT
Reply posted to the selected tweet, confirmed in terminal output
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
X (Twitter) account with an active logged-in session in Firefox or ChromeSWEETISTICS_API_KEY environment variable (required only when using the Sweetistics engine)