bird

bird is a skill for Claude Code, Codex from metaspartan/cybara. It costs 18 tokens per session (1,373 once invoked), scanned A, a copy of bird, MIT.

A command-line tool for reading, searching, posting on, and interacting with X, formerly called Twitter, using account cookies.

In plain words
What is it for?
Check the logged-in account, read posts and conversations, search timelines, view replies and mentions, and perform posting or engagement actions.
Why use it?
It gives scripts and agents a way to work with X accounts and posts from the terminal, provided the required login cookies are available.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Check the logged-in account, read posts and conversations, search timelines, view replies and mentions, and perform posting or engagement actions.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/metaspartan/cybara/bird
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add metaspartan/cybara --skill bird
Clone the repo
git clone --depth 1 https://github.com/metaspartan/cybara

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bird

README.md
[![agentmods](https://agentmods.dev/badge/skills/metaspartan/cybara/bird/github.svg)](https://agentmods.dev/skills/metaspartan/cybara/bird)
Your own site
<a href="https://agentmods.dev/skills/metaspartan/cybara/bird"><img src="https://agentmods.dev/badge/skills/metaspartan/cybara/bird/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for bird

Your own site · 80×15
<a href="https://agentmods.dev/skills/metaspartan/cybara/bird"><img src="https://agentmods.dev/badge/skills/metaspartan/cybara/bird.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,373 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 92% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00018 $0.01373
Opus 5.5 $0.00007 $0.00549
Sonnet 5.5 $0.00004 $0.00275
Haiku 4.5 $0.00002 $0.00137

Measured 1mo ago against content hash 4e292146ae92, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

bird scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

92% identical to bird — 31 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/bird/SKILL.md · 198 lines

How it starts

The opening of the file, as written. The whole thing — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.

bird 🐦

Fast X/Twitter CLI using GraphQL + cookie auth.

Install

# npm/pnpm/bun
npm install -g @steipete/bird

# Homebrew (macOS, prebuilt binary)
brew install steipete/tap/bird

# One-shot (no install)
bunx @steipete/bird whoami

Authentication

bird uses cookie-based auth.

Use --auth-token / --ct0 to pass cookies directly, or --cookie-source for browser cookies.

Run bird check to see which source is active. For Arc/Brave, use --chrome-profile-dir <path>.

Commands

Account & Auth

bird whoami                    # Show logged-in account
bird check                     # Show credential sources
bird query-ids --fresh         # Refresh GraphQL query ID cache

Reading Tweets

bird read <url-or-id>          # Read a single tweet
bird <url-or-id>               # Shorthand for read
bird thread <url-or-id>        # Full conversation thread
bird replies <url-or-id>       # List replies to a tweet

Timelines

bird home                      # Home timeline (For You)
bird home --following          # Following timeline
bird user-tweets @handle -n 20 # User's profile timeline
bird mentions                  # Tweets mentioning you
bird mentions --user @handle   # Mentions of another user

Search

bird search "query" -n 10
bird search "from:steipete" --all --max-pages 3

News & Trending

bird news -n 10                # AI-curated from Explore tabs
bird news --ai-only            # Filter to AI-curated only
bird news --sports             # Sports tab
bird news --with-tweets        # Include related tweets
bird trending                  # Alias for news

Lists

bird lists                     # Your lists
bird lists --member-of         # Lists you're a member of
bird list-timeline <id> -n 20  # Tweets from a list

Bookmarks & Likes

bird bookmarks -n 10
bird bookmarks --folder-id <id>           # Specific folder
bird bookmarks --include-parent           # Include parent tweet
bird bookmarks --author-chain             # Author's self-reply chain
bird bookmarks --full-chain-only          # Full reply chain
bird unbookmark <url-or-id>
bird likes -n 10

Read the full file on GitHub · 198 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 198 lines · 18 tokens per session scan A 4e292146ae92

Subscribe to this mod's changes

bird is a skill published in the GitHub repository metaspartan/cybara (32 stars, last pushed 2d ago), licensed MIT. It adds 18 tokens to every session and 1,373 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 92% identical to bird, differing in 31 lines, and is treated as a copy.