bird

bird is a skill for Claude Code, Codex from smallnest/goclaw. It costs 18 tokens per session (1,429 once invoked), scanned A, original, MIT.

A command-line tool for reading, searching, posting on, and interacting with X, formerly called Twitter. It uses browser-style cookies to authenticate an account.

In plain words
What is it for?
Reading posts and threads, searching, viewing timelines and mentions, checking an account, posting, and handling engagement actions.
Why use it?
It provides terminal access to X actions without requiring a separate graphical client.

Skill for Claude CodeCodex

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

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.

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

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/smallnest/goclaw/bird.svg)](https://agentmods.dev/skills/smallnest/goclaw/bird)
Your own site
<a href="https://agentmods.dev/skills/smallnest/goclaw/bird"><img src="https://agentmods.dev/badge/skills/smallnest/goclaw/bird.svg" alt="Measured on agentmods" 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,429 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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.01429
Opus 5 $0.00009 $0.00714
Sonnet 5 $0.00004 $0.00286
Haiku 4.5 $0.00002 $0.00143

Measured 6d ago against content hash a27b9bd70899, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, 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 6d 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

Copies of this mod

7 near-identical copies found in the catalogue:

  • bird — 98% identical, 2 lines differ
  • bird — 98% identical, 2 lines differ
  • bird — 95% identical, 31 lines differ
  • bird — 92% identical, 31 lines differ
  • bird — 92% identical, 31 lines differ
  • bird — 92% identical, 31 lines differ
  • bird — 91% identical, 33 lines differ
internal/builtin_skills/bird/SKILL.md · 225 lines

How it starts

The opening of the file, as written. The whole thing — 225 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 · 225 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. 6d ago First seen · 225 lines · 18 tokens per session scan A a27b9bd70899

Subscribe to this mod's changes

bird is a skill published in the GitHub repository smallnest/goclaw (603 stars, last pushed 5mo ago), licensed MIT. It adds 18 tokens to every session and 1,429 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories