Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

bird

X/Twitter CLI for posting tweets, reading threads, searching, and fetching news. Use when user asks to tweet, reply, read tweets, search X/Twitter, get mentions, view bookmarks, likes, followers, following, user timelines, or fetch trending news/topics.

dannote · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add dannote/dot-pi --skill bird

About this skill


name: bird description: X/Twitter CLI for posting tweets, reading threads, searching, and fetching news. Use when user asks to tweet, reply, read tweets, search X/Twitter, get mentions, view bookmarks, likes, followers, following, user timelines, or fetch trending news/topics.

bird — X/Twitter CLI

This skill targets my @dannote/bird-premium package, which installs a bird binary. It is a fork of/derived from Peter Steinberger's original steipete/bird CLI, but uses the documented paid X API v2 instead of undocumented web GraphQL/cookie endpoints.

  • Package: @dannote/bird-premium
  • Original project credited: steipete/bird
  • Transport: official X API v2 with OAuth 1.0a and Bearer Token auth

Install

# one-shot (no install)
bunx @dannote/bird-premium whoami

# or install globally
npm install -g @dannote/bird-premium
# or: pnpm add -g @dannote/bird-premium
# or: bun add -g @dannote/bird-premium

Authentication

Env vars:

  • Bearer Token (app-only): X_BEARER_TOKEN
  • OAuth 1.0a (user context): X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET

Bearer Token enables: search, read, user, user-tweets, followers, following OAuth 1.0a adds: tweet, reply, like, retweet, bookmark, follow, home, whoami, mentions

Commands

Post & Reply

bird tweet "Hello world"
bird tweet "Quote this" --quote <tweet-id>
bird reply <tweet-id-or-url> "Reply text"

Read

bird read <tweet-id-or-url>

Search

bird search "query" -n 20

Search covers the last 7 days.

Mentions

bird mentions -n 5
bird mentions <username> -n 5

Timelines

bird home -n 20
bird user-tweets <username> -n 20
bird user-tweets <username> --no-replies --no-retweets
bird list-timeline <list-id> -n 20

Bookmarks & Likes

bird bookmarks -n 10
bird likes -n 10
bird likes <username> -n 10
bird bookmark <tweet-id>
bird unbookmark <tweet-id>
bird like <tweet-id>
bird unlike <tweet-id>

Social Graph

bird followers <username> -n 20
bird following <username> -n 20
bird follow <username>
bird unfollow <username>

Retweets

bird retweet <tweet-id>
bird unretweet <tweet-id>

User Profile

bird user <username>

Account

bird whoami
bird check

Delete

bird delete <tweet-id>

Global Options

FlagDescription
--jsonJSON output
-n, --count <n>Number of results
--cursor <token>Resume from cursor

JSON Output Schema

Tweet objects:

  • id, text, author ({username, name}), authorId
  • createdAt, conversationId, inReplyToStatusId
  • replyCount, retweetCount, likeCount
  • quotedTweet (nested)

User objects (following/followers):

  • id, username, name, description
  • followersCount, followingCount, isBlueVerified