bird

bird is a skill for Claude Code, Codex from dannote/dot-pi. It costs 57 tokens per session (858 once invoked), scanned A, original, MIT.

A command-line tool for X, formerly called Twitter, that can read, search, and publish posts and retrieve account-related information. It uses the official X API and supports different access levels through authentication.

In plain words
What is it for?
Use it to publish or reply to posts, read threads, search X, inspect timelines, manage follows and bookmarks, and fetch mentions or trending topics.
Why use it?
It gives an agent terminal commands for working with X without relying on undocumented website interfaces. Some actions, such as posting or liking, need user-authorized credentials.

Skill for Claude CodeCodex

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/dannote/dot-pi/bird
Any agent
npx skills add dannote/dot-pi --skill bird
Clone the repo
git clone --depth 1 https://github.com/dannote/dot-pi

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/dannote/dot-pi/bird.svg)](https://agentmods.dev/skills/dannote/dot-pi/bird)
Your own site
<a href="https://agentmods.dev/skills/dannote/dot-pi/bird"><img src="https://agentmods.dev/badge/skills/dannote/dot-pi/bird.svg" alt="Measured on agentmods" height="20"></a>
Per session 57 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 858 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 $0.00057 $0.00858
Opus 5 $0.00028 $0.00429
Sonnet 5 $0.00011 $0.00172
Haiku 4.5 $0.00006 $0.00086

Measured 4d ago against content hash f56f06befff6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 4d 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.

skills/bird/SKILL.md · 144 lines

How it starts

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

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>

Read the full file on GitHub · 144 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. 4d ago First seen · 144 lines · 57 tokens per session scan A f56f06befff6

Subscribe to this mod's changes

bird is a skill published in the GitHub repository dannote/dot-pi (51 stars, last pushed today), licensed MIT. It adds 57 tokens to every session and 858 once invoked, about $0.0003 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

a0-development

Development guide for extending Agent Zero from current source and DOX. Use for framework architecture, tools, extensions, API/WebUI handlers, agent profiles, prompts, skills, projects, runtime boundaries, and contribution workflow. Load the focused reference files before giving implementation guidance.

agent0ai/agent-zero · 57 tokens

temporal-developer

Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET, Ruby, and Rust. Use when the user is building workflows, activities, or workers with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or…

temporalio/skill-temporal-developer · 161 tokens

skill-author

Teach an author how to integrate the CAFleet-orchestrated team pattern into a new skill they are writing. Auto-load when the author intends to create a new CAFleet-orchestrated skill, write a skill that spawns cafleet members, add a Director/Member team skill, design a multi-agent broker-coordinated skill, build a…

himkt/cafleet · 126 tokens

clean-docs

Clean up the repository's docs, comments, rules, and tests as a CAFleet team of disjoint-slice scanner members gated by a reviewer — exactly one workflow per run. Use the residue workflow when the user asks to clean up historical narration or historical residue, remove deprecation notes / "this replaces X" / "renamed…

himkt/cafleet · 195 tokens

cafleet

Interact with the CAFleet message broker and supervise CAFleet member teams. Use when an agent needs to register as a member, send/receive messages, poll inbox, acknowledge messages, or discover other members; or when a Director is about to spawn, monitor, health-check, or recover a stalled team of CAFleet members…

himkt/cafleet · 87 tokens

anycap-human-interaction

Collect structured visual feedback from humans using AnyCap's annotation tool, or create and iterate on diagrams using the interactive whiteboard (Excalidraw). Covers image annotation, URL/web page review with screen recording, video review, audio feedback, and collaborative diagramming with Mermaid input. Use when…

anycap-ai/anycap · 190 tokens