mcpField
B
beeper

beeper

github.com/steipeteProductivity7.4k100 installsUpdated 1w ago
Repository

About beeper

beeper is a skill for answering questions about local Beeper message history, including searches based on vague contact clues across iMessage and WhatsApp bridges. It narrows results by account, room, participant, and date, while keeping the database results local.

Key features

  1. 01Inspect accounts, participants, and rooms
  2. 02Search message text with FTS
  3. 03Narrow results by date and participant
  4. 04Report room, account, dates, and confidence
  5. 05Keep message results local

Use cases

  1. 01Find messages using an approximate contact hint
  2. 02Locate messages from a particular participant or period
  3. 03Summarize the likely room and account for matching history

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/steipete/agent-scripts --skill beeper

After installing, type/beeperin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported