beeper

---
name: beeper
description: "Use when working with beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/beeper
generated: 2026-05-27T20:55:17.900Z
category: tool
audience: general
---

## When to use

- Local Beeper history questions, especially vague contact hints across iMessage/WhatsApp bridges.
- Using the beeper skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing beeper behavior.
- Needing a compact agent reference for beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

## Key concepts

### Source

DB: ~/Library/Application Support/BeeperTexts/index.db FTS: mxroommessagesfts Start by inspecting accounts/rooms before broad searching.

### Workflow

1. Identify likely account/bridge/room from accounts, participants, and room tables. 2. Use FTS for text discovery. 3. Narrow by date, participant, and room. 4. Report room/account names, date spans, and confidence. Useful probes: Keep results local; this DB can contain private messages.

### Source-first workflow

Start from the upstream beeper instructions and local project context before inventing commands or workflows.

## API reference

```
npx skills add steipete/agent-scripts --skill beeper
```

Install the beeper skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill beeper
```

```
sqlite3 "$HOME/Library/Application Support/BeeperTexts/index.db" \.
```

Command or snippet documented by the upstream beeper skill.

```
sqlite3 "$HOME/Library/Application Support/BeeperTexts/index.db" \
  "select * from accounts limit 20;"
```

```
sqlite3 "$HOME/Library/Application Support/BeeperTexts/index.db" \.
```

Command or snippet documented by the upstream beeper skill.

```
sqlite3 "$HOME/Library/Application Support/BeeperTexts/index.db" \
  "select rowid, content from mx_room_messages_fts where mx_room_messages_fts match 'query' limit 20;"
```

## Gotchas

- Read the upstream SKILL.md before use; several entries encode machine-specific paths, credentials, or local operational assumptions.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/beeper on 2026-05-27T20:55:17.900Z.
Verify against source before relying on details.

File: ~/.claude/skills/beeper/SKILL.md