# steipete/birdclaw

Stores all your tweets nicely claw-able for agents.

Repository: https://github.com/steipete/birdclaw
Canonical: https://ross.abutalabs.com/products/birdclaw
Homepage: https://birdclaw.sh
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-19T01:55:24+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 96, longevity 12
- inputs: {"age_days": 178, "days_push": 15, "days_rel": 25, "gap_med": 2.0, "n_releases_24m": 29}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1634, forks 160 (observed 2026-08-28T04:05:14.346326+00:00)

## What it is
Birdclaw is a local-first Twitter/X workspace that imports your Twitter archive into a local SQLite database with FTS5 full-text search, exposing it via a CLI, a local web app, and an optional read-only MCP server for agents. It supports tweets, DMs, likes, bookmarks, mentions, and the follow graph without any cloud backend.

## Use cases
- search my entire twitter history locally
- import my twitter archive into sqlite
- let AI agents query my tweets via MCP
- back up my twitter DMs and bookmarks
- search tweets I've liked offline
- triage my twitter mentions inbox
- run a local twitter archive viewer with a web UI

## When to choose
- you want your Twitter/X history searchable locally without a cloud service
- you want to expose your tweet history to AI agents through MCP
- you prefer archive-first, privacy-respecting local storage in SQLite
- you want both a CLI and web interface over the same data

## When to avoid
- you need real-time Twitter streaming or heavy live API usage
- you want a hosted, multi-device synced solution
- you don't have a Twitter archive and don't want to request one
- you need write/posting features as the core workflow (live writes are delegated to external tools)

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, cli, http-server, mcp, database, data-science
- domain: social-media, self-hosted, developer-tools, privacy, databases
- platform: cli, self-hosted
- tags: twitter-archive, local-first, sqlite, fts5, mcp-server, social-media-backup, ai-agent-tools, search, macos, linux, nodejs

## Member repositories
- steipete/birdclaw (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:14.346326+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:47:09.784516+00:00, confidence not recorded.
  - readme: https://github.com/steipete/birdclaw (fetched 2026-08-28T04:05:14.346326+00:00, sha e6e326c730b6)
  - homepage: https://birdclaw.sh (fetched 2026-08-29T11:20:26.106128+00:00, sha 972de17ac164)
  - site_page: https://birdclaw.sh/install.html (fetched 2026-08-29T11:20:26.109933+00:00, sha cb3871ec724f)
  - site_page: https://birdclaw.sh/quickstart.html (fetched 2026-08-29T11:20:26.111784+00:00, sha a4cfe0b6cf7b)
  - registry_npm: https://registry.npmjs.org/birdclaw (fetched 2026-08-29T11:20:26.113421+00:00, sha c7f6ed2d389b)
- Data as of 2026-08-30T08:39:29.467469+00:00.