home / skills / z980944038-dev / openclawwdl / bird-1.0.0

bird-1.0.0 skill

/skills/bird-1.0.0

This skill lets you read, search, and post on X using cookies or Sweetistics, simplifying management of tweets and threads.

npx playbooks add skill z980944038-dev/openclawwdl --skill bird-1.0.0

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

751 B

---
name: bird
description: X/Twitter CLI for reading, searching, and posting via cookies or Sweetistics.
homepage: https://bird.fast
metadata: {"clawdbot":{"emoji":"🐦","requires":{"bins":["bird"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/bird","bins":["bird"],"label":"Install bird (brew)"}]}}
---

# 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`

Overview

This skill is a command-line interface for reading, searching, and posting on X (Twitter) using either browser cookies or the Sweetistics API. It provides fast, scriptable commands for viewing timelines, reading threads, searching posts, and composing tweets or replies. The tool is lightweight, works from the terminal, and supports common auth flows for personal accounts.

How this skill works

The CLI inspects provided X URLs or IDs to fetch full tweet content, threads, and conversation context. It can search X with a simple query string and return a limited number of results. For posting, it uses browser session cookies by default or the Sweetistics API when configured, and prompts for confirmation before sending tweets or replies.

When to use it

Quickly read a tweet or full thread from a terminal session
Search X results for a keyword or phrase from scripts
Post or reply to tweets from automated workflows with confirmation
Validate available authentication sources and switch engines
Integrate X reading/posting into shell aliases or CI tasks

Best practices

Use browser cookies stored in Firefox/Chrome for direct account access when testing locally
Set SWEETISTICS_API_KEY for a server-friendly posting option instead of exposing cookies
Always review the confirmation prompt before posting to avoid accidental tweets
Limit search results (e.g., -n 5) to keep output concise in scripts
Run bird check to verify authentication sources before critical operations

Example use cases

bird whoami to confirm the active account
bird read <url-or-id> to display a single tweet with media and metadata
bird thread <url-or-id> to fetch and print an entire conversation thread
bird search "query" -n 5 to collect recent relevant tweets for research
bird tweet "text" or bird reply <id-or-url> "text" to compose posts from the terminal

FAQ

How does authentication work?

By default bird reads browser cookies from Chrome/Firefox to act as your logged-in session. Alternatively set SWEETISTICS_API_KEY or pass --engine sweetistics to use the Sweetistics API.

Will bird post without asking?

No. Posting commands prompt for confirmation before sending a tweet or reply to prevent accidental posts.

Can I use bird in scripts or CI?

Yes. Use Sweetistics API keys for non-interactive environments and limit outputs for predictable scripting.