// Local-first Twitter/X workspace for archiving, searching, and triaging tweets, DMs, likes, bookmarks, and mentions. Includes a web UI for inbox triage and AI scoring.
| name | birdclaw |
| description | Local-first Twitter/X workspace for archiving, searching, and triaging tweets, DMs, likes, bookmarks, and mentions. Includes a web UI for inbox triage and AI scoring. |
| platforms | ["darwin"] |
| homepage | https://github.com/steipete/birdclaw |
| requires | {"any_bins":["birdclaw"],"install":[{"kind":"brew","formula":"steipete/tap/birdclaw","bins":["birdclaw"],"os":["darwin"]}]} |
| origin | {"source":"moltis","url":"https://github.com/moltis-org/moltis"} |
birdclaw is a local-first Twitter workspace that archives, manages, and triages Twitter data (tweets, DMs, likes, bookmarks, mentions) in a self-hosted SQLite database. Includes a web UI for triage.
This complements the xurl skill — xurl is for interacting with the X API (posting, searching, engaging); birdclaw is for archiving and triaging your Twitter data locally.
xurl when configured — same secret safety rules apply.~/.birdclaw/config.json or ~/.xurl to LLM context.OPENAI_API_KEY env var or Moltis credential store.birdclaw works in multiple modes:
For full API access, set up xurl first (see the xurl skill), then:
birdclaw setup
birdclaw doctor
birdclaw doctor
birdclaw import /path/to/twitter-archive.zip
birdclaw sync # Sync all (timeline, mentions, DMs, likes, bookmarks)
birdclaw sync --timeline # Just timeline
birdclaw sync --mentions # Just mentions
birdclaw sync --dms # Just DMs
birdclaw sync --likes # Just likes
birdclaw sync --bookmarks # Just bookmarks
birdclaw search "query"
birdclaw search "query" --limit 20 --json
birdclaw search "query" --from @handle
birdclaw search "query" --after 2026-01-01
birdclaw inbox # Show untriaged items
birdclaw inbox --json
birdclaw inbox score # Run AI scoring on inbox items
birdclaw serve # Start web UI at localhost:3000
Views: Home, Mentions, Likes, Bookmarks, DMs, Inbox (triage), Blocks.
birdclaw export --json # Full JSON export
birdclaw export --format jsonl --output /path/ # JSONL shards for Git backup
To archive Twitter data into Moltis memory:
--jsonmemory/twitter/YYYY-MM-DD.md# Twitter/X — 2026-04-28
## Mentions
- @alice replied to our thread about Rust async — positive feedback
- @bob asked about the API rate limits in v2
## Bookmarks
- Thread by @techwriter on database migration patterns (saved for reference)
- Article: "Zero-downtime deployments with blue-green"
## DMs
- @carol: confirmed speaking slot at RustConf
~/.birdclaw/birdclaw.db (SQLite + FTS5).--json for machine-readable output.OPENAI_API_KEY — optional, not needed for basic triage.Archive and search Slack workspace messages, threads, and channels via the slacrawl CLI. Supports API sync, Slack export ZIP import, local desktop cache import, and full-text search.
Archive and search Discord guild messages, threads, and members via the discrawl CLI. Supports bot API sync, local cache import, full-text and semantic search, and Git-backed NDJSON snapshots.
Create and manage webhook subscriptions for event-driven agent activation. Use when the user wants external services (GitHub, GitLab, Stripe, Linear, PagerDuty, Sentry, or any generic source) to trigger agent runs by POSTing events to a URL.
Read-only local archive and full-text search of WhatsApp Desktop messages via the wacrawl CLI. Use for searching chat history, exporting conversations, and creating encrypted backups. macOS only (reads local WhatsApp Desktop SQLite databases).
Sync and archive data from messaging platforms (WhatsApp, Discord, Slack, Twitter/X, Google) into Moltis memory as daily digest summaries. Orchestrates crawl tools and writes structured markdown to the memory system.
Add, remove, configure, and troubleshoot MCP (Model Context Protocol) servers. Use when the user wants to connect external tools, manage MCP server lifecycle, or debug MCP connectivity issues.