← ClaudeAtlas

beeper-clilisted

Read-only CLI for browsing, opening, and searching local Beeper chat history (SQLite-based)
KrauseFx/beeper-cli · ★ 31 · Data & Documents · score 73
Install: claude install-skill KrauseFx/beeper-cli
# Beeper CLI Read-only access to local Beeper Desktop SQLite database for AI agents and automation. ## Features - ✅ List threads/conversations - ✅ Read messages with full metadata - ✅ Full-text search (FTS5) - ✅ Access to image/file attachments metadata - ✅ JSON output for agent integration - ✅ Contact name resolution from bridge databases ## Setup **Built:** ✅ Pre-compiled binary at `skills/beeper-cli/beeper-cli` **Requirements:** - Go 1.22+ (for rebuilding only) - Beeper Desktop installed - SQLite database at: `~/Library/Application Support/BeeperTexts/index.db` **Rebuild** (if needed): ```bash cd skills/beeper-cli go build -o beeper-cli ./cmd/beeper-cli ``` ## Usage ### Wrapper script ```bash cd skills/beeper-cli ./run.sh <command> ``` ### List threads ```bash ./run.sh threads list --limit 50 ./run.sh threads list --days 7 ./run.sh threads list --json ``` ### Read messages ```bash ./run.sh messages list --thread "!abc123:beeper.local" --limit 50 ./run.sh messages list --thread "!abc123:beeper.local" --json ``` ### Search messages ```bash ./run.sh search "christmas party" --limit 20 ./run.sh search "party NEAR/5 christmas" --context 6 ./run.sh search "invoice" --json ``` ### Database info ```bash ./run.sh db info ``` ## Accessing Images & Attachments Messages with type `IMAGE`, `FILE`, `VIDEO`, etc. contain attachment metadata in the SQLite database. **Direct SQLite query to get image URLs:** ```bash sqlite3 ~/Library/Application\ Support/BeeperTexts/index.d