steipete/birdclaw là dự án mã nguồn mở trên GitHub, viết chủ yếu bằng TypeScript, với 1.7k sao. Stores all your tweets nicely claw-able for agents.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
birdclaw 🪶 — Your Twitter history, with a longer memory
Birdclaw imports Twitter/X archives into local SQLite, adds explicit cached live reads, and exposes the result through a web app, CLI, and optional read-only MCP server. It is for people who want their own searchable history, DMs, saved posts, and follow graph without a cloud backend.
Install
Homebrew is the shortest path on macOS and Linux:
brew install steipete/tap/birdclaw
The package is also published on npm:
npm install -g birdclaw
The npm and Homebrew installs retain the public Node.js >=26.5.1 <27 contract. Source development uses one checksum-pinned Bun 1.4.0-canary.1 build and keeps Node as a tested compatibility lane. See the installation guide for setup and the Bun canary reference for exact checksums, constraints, and rollback boundaries.
Quick start
Create a self-contained demo, search it locally, then open the web app:
Open http://localhost:3000. The demo seeds sample tweets, DMs, profiles, and links without credentials or network requests.
Use your archive
A Twitter/X archive establishes the account identity for a new real database and imports tweets, DMs, likes, bookmarks, profiles, media, and follow edges:
Import an archive before the first live sync on a new database. The sign-in guide explains xurl setup and transport selection; the sync guide covers caching, pagination, and rate limits.
Work locally
SQLite is the canonical store. Archive imports and live transports converge on the same tables, and FTS5 powers local tweet and DM search.
Surface
What it provides
Guide
Web app
Home, mentions, saved posts, DMs, inbox, moderation, and network views
Quickstart
CLI
Search, sync, moderation, research, JSON output, and scheduled jobs
CLI reference
Backup
Deterministic JSONL shards that round-trip through Git
Backup
MCP
Read-only cached tweet search and thread tools behind a dedicated token
MCP server
Local reads do not trigger network traffic by default. The web server listens on loopback, live writes can be disabled with BIRDCLAW_DISABLE_LIVE_WRITES=1, and the MCP endpoint remains off until its token and public URL are configured.
Bird is optional: xurl supports ordinary live workflows and moderation, while native web access handles DM requests using AUTH_TOKEN and CT0 session cookies. Neither native request access nor xurl moderation needs a browser process. See running without bird.
For an archive-only server, set BIRDCLAW_DEPLOYMENT_READ_ONLY=1 before birdclaw serve. This opt-in mode serves an initialized archive through strict readers, disables web mutations and automatic sync, and hides unavailable controls. See read-only archive deployments for its authentication and storage requirements.
Configuration
~/.birdclaw/config.json selects default accounts, transport preferences, mention sources, and backup behavior. Command flags override environment variables, which override the config file.
See Configuration for the complete file and environment reference. Product boundaries live in VISION.md, and storage and transport details live in Data and architecture.
Development
./scripts/bun-canary.sh install --frozen-lockfile
./scripts/bun-canary.sh run --bun check
./scripts/bun-canary.sh run --bun test
./scripts/bun-canary.sh run --bun build
Vite generates the compact app/favicon logo from the original artwork during configuration. The derivative lives in .generated/birdclaw-brand/ and is emitted with a content hash; the full-resolution documentation image remains unchanged. Sharp is a build-only dependency.
The CLI build bundles the Effect modules it uses to reduce process startup work. Other direct dependencies remain external, and the installed package keeps the same Node and Bun runtime contracts.
The wrapper installs and verifies the exact Rust-port canary recorded in toolchains/bun-canary.conf; it refuses a newer rolling canary with a different checksum or revision. CI also runs Bun/Istanbul and Node/V8 coverage, dual-runtime installed-package smoke, and Playwright against the Bun production server.
License
MIT. Created by Peter Steinberger. Birdclaw is not affiliated with X Corp.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/steipete/birdclaw là nguồn chính thức.
steipete/birdclaw có bao nhiêu sao?
steipete/birdclaw có 1.7k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/steipete/birdclaw. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
steipete/birdclaw có phải mã nguồn mở không?
Có — steipete/birdclaw phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/steipete/birdclaw.
steipete/birdclaw có trang demo không?
Dự án có trang chủ ở https://birdclaw.sh. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
steipete/birdclaw là gì?
steipete/birdclaw (steipete/birdclaw) là dự án TypeScript trên GitHub. Theo mô tả gốc: Stores all your tweets nicely claw-able for agents.
Đọc đầy đủ README ở tab phía trên.
birdclaw có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về birdclaw.