beeper-clilisted
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