{"id":50713615,"url":"https://github.com/zaydiscold/bird","last_synced_at":"2026-06-09T17:03:40.219Z","repository":{"id":349746268,"uuid":"1173791868","full_name":"zaydiscold/bird","owner":"zaydiscold","description":"fast cli for twitter/x, by @steipete. mirrored here so the tool stays accessible after the original repo was removed.","archived":false,"fork":false,"pushed_at":"2026-06-08T10:35:50.000Z","size":220,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T12:25:12.520Z","etag":null,"topics":["bird","cli","homebrew","safari-cookies","twitter","x"],"latest_commit_sha":null,"homepage":"https://github.com/steipete/bird","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zaydiscold.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T18:54:22.000Z","updated_at":"2026-06-08T10:36:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zaydiscold/bird","commit_stats":null,"previous_names":["zaydiscold/bird"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zaydiscold/bird","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zaydiscold","download_url":"https://codeload.github.com/zaydiscold/bird/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaydiscold%2Fbird/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34116461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bird","cli","homebrew","safari-cookies","twitter","x"],"created_at":"2026-06-09T17:03:39.489Z","updated_at":"2026-06-09T17:03:40.212Z","avatar_url":"https://github.com/zaydiscold.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- thanks supersuper for being on my ass :) --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/banner.svg\" alt=\"banner\" /\u003e\n\u003c/p\u003e\n\n\u003c!-- add signature.svg to ./assets/ --\u003e\n\n\u003ch1 align=\"center\"\u003ebird\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003efast cli for twitter/x. built by \u003ca href=\"https://x.com/steipete\"\u003e@steipete\u003c/a\u003e. mirrored here so it stays accessible.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/cli-v0.8.0-B4A7D6?style=flat-square\u0026labelColor=1a1a2e\" alt=\"cli\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macos-universal-5F9EA0?style=flat-square\u0026labelColor=1a1a2e\" alt=\"macos\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/zayd.wtf-D4AF37?style=flat-square\u0026labelColor=1a1a2e\" alt=\"site\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#what-it-does\"\u003ewhat it does\u003c/a\u003e · \u003ca href=\"#install\"\u003einstall\u003c/a\u003e · \u003ca href=\"#usage\"\u003eusage\u003c/a\u003e · \u003ca href=\"#use-with-ai-agents\"\u003eai agents\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars1.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## what it does\n\nbird is a cli for reading and posting on twitter/x. no api keys. no oauth dance. it reads cookies directly from safari or chrome.\n\nthe original [steipete/bird](https://github.com/steipete/bird) repo was removed from github. this mirror exists so people who depend on the tool can still get it. all credit for the cli goes to [@steipete](https://x.com/steipete) (Peter Steinberger). i'm just keeping the lights on.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars2.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## install\n\n```bash\n# direct download — universal arm64/x86_64 binary from this mirror\ncurl -L https://github.com/zaydiscold/bird/releases/download/v0.8.0/bird -o bird\nchmod +x bird\nsudo mv bird /usr/local/bin/bird\n```\n\nor with wget:\n\n```bash\nwget -O bird https://github.com/zaydiscold/bird/releases/download/v0.8.0/bird\nchmod +x bird\nsudo mv bird /usr/local/bin/bird\n```\n\n\u003e **note on homebrew:** steipete's tap (`brew install steipete/tap/bird`) was the original install method. i'm not sure if that tap is still maintained — it may be down. use the curl install above to be safe.\u003cbr\u003e\n\u003e \u003csub\u003esteipete's original tap: `brew install steipete/tap/bird`\u003c/sub\u003e\n\nverify:\n\n```bash\nbird whoami  # returns your twitter handle\n```\n\nrequires being logged into x.com in safari or chrome.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars3.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## usage\n\nbird auto-detects safari cookies. no setup.\n\n```bash\nbird whoami                          # confirm logged-in account\nbird check                           # check cookie availability\nbird --chrome-profile \"Default\" ...  # use chrome instead of safari\n```\n\n### read\n\n```bash\nbird read \u003curl-or-id\u003e                # single tweet\nbird thread \u003curl-or-id\u003e              # full conversation thread\nbird thread \u003curl-or-id\u003e --all        # thread, all pages\nbird replies \u003curl-or-id\u003e             # replies to a tweet\nbird user-tweets @handle -n 20       # user's recent tweets\n```\n\n### search\n\n```bash\nbird search \"query\" -n 20\nbird search \"from:@handle keyword\" -n 10\nbird search \"term\" --all             # paginate through everything\n```\n\n### timeline\n\n```bash\nbird home -n 20                      # for you feed\nbird home --following -n 20          # following, chronological\nbird mentions -n 20                  # your mentions\nbird bookmarks -n 20                 # saved bookmarks\nbird likes -n 20                     # liked tweets\nbird lists                           # your lists\nbird list-timeline \u003clist-id-or-url\u003e  # list timeline\nbird about @handle                   # account origin and location\nbird following -n 50                 # who you follow\nbird followers -n 50                 # your followers\n```\n\n### post\n\n```bash\nbird tweet \"text here\"\nbird reply \u003curl-or-id\u003e \"reply text\"\nbird follow @handle\nbird unfollow @handle\n\n# attach media — up to 4 images or 1 video\nbird tweet \"caption\" --media /path/to/image.jpg --alt \"alt text\"\nbird tweet \"caption\" --media /path/to/video.mp4\n\n# long posts (X Premium): text over 280 weighted chars is auto-routed\n# through CreateNoteTweet — no flag needed, just write a long tweet\nbird tweet \"$(cat my-long-post.txt)\"\n```\n\n**long posts / note tweets (new in 0.9.0):** if your text exceeds the standard\n280 weighted-char limit (URLs count as 23), `tweet`/`reply` automatically use\nX's `CreateNoteTweet` mutation instead of `CreateTweet`. Requires X Premium on\nthe account. Short tweets are unaffected — they still use the cheap path. The\nnote-tweet request carries the distinct feature-flag set + `fieldToggles` that\nX's web client sends, so it passes server-side validation.\n\n### output\n\n```bash\nbird read \u003cid\u003e --json           # structured json\nbird read \u003cid\u003e --json-full      # json + raw api response\nbird search \"query\" --plain     # no color, pipeable\n```\n\n\u003csub\u003eflags: `-n` result count · `--all` paginate · `--following` filter · `--ai-only` curated news · `--with-tweets` include tweets · `--tweets-per-item N` · `--chrome-profile \"Name\"` · `--json` · `--json-full` · `--plain` · `--media path` · `--alt text`\u003c/sub\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars4.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## use with ai agents\n\nfor claude code, cursor, codex, and other ai agents: **[zaydiscold/bird-skill](https://github.com/zaydiscold/bird-skill)**\n\ni built the skill myself. paste any x.com link into a claude code session and it reads the tweet directly — no browser, no webfetch. it also handles timelines, search, posting, all of it. homegrown, built to work on top of peter's binary.\n\n```bash\nnpx skills add zaydiscold/bird-skill@bird -g -y\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars5.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#zaydiscold/bird\u0026Date\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=zaydiscold/bird\u0026type=Date\u0026theme=dark\" /\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=zaydiscold/bird\u0026type=Date\" /\u003e\n      \u003cimg src=\"https://api.star-history.com/svg?repos=zaydiscold/bird\u0026type=Date\u0026theme=dark\" width=\"320\" alt=\"star history chart\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003emit. \u003ca href=\"./LICENSE\"\u003elicense\u003c/a\u003e\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/stars6.svg\" alt=\"·\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"left\"\u003e\u003cstrong\u003ezayd / cold\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://zayd.wtf\"\u003ezayd.wtf\u003c/a\u003e · \u003ca href=\"https://x.com/coldcooks\"\u003etwitter\u003c/a\u003e · \u003ca href=\"https://github.com/zaydiscold\"\u003egithub\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003eicarus only fell because he flew\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"right\"\u003e\n  \u003cstrong\u003eto do\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003e\n  ☑ mirror binary + release\u003cbr\u003e\n  ☑ homebrew formula\u003cbr\u003e\n  ☑ bird-skill for ai agents\u003cbr\u003e\n  ☐ auto-update check on install\n  \u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/wisps.svg\" alt=\"\" /\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaydiscold%2Fbird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaydiscold%2Fbird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaydiscold%2Fbird/lists"}