Skills

Beeper Cache

Searches the Beeper cache for contacts, rooms and message traces.

Install

npx skills add steipete/agent-scripts --skill beeper -g -a claude-code -y
Category
Engineering
Updated
5d ago
License
MIT
Context cost
Lightabout 222 tokens
Runs scripts
No, instructions only

What it does

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

Beeper

Use this for local Beeper history questions, especially vague contact hints across iMessage/WhatsApp bridges.

Source

  • DB: ~/Library/Application Support/BeeperTexts/index.db
  • FTS: mx_room_messages_fts

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:

sqlite3 "$HOME/Library/Application Support/BeeperTexts/index.db" \
  "select * from accounts limit 20;"
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;"

Keep results local; this DB can contain private messages.

More in Engineering