Beeper

SkillCommunication

Lets your agent search your local Beeper chat history across iMessage and WhatsApp by contact, room, or keyword.

Then ask your AI: use the Beeper skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

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

What this skill tells your AI

The instructions your AI receives, as published by steipete/agent-scripts in skills/beeper/SKILL.md and read by Ahel’s review.

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.

Signals

GitHub stars
7k
Forks
635
Last commit
Oct 2026
Advanced
Item type
skill
Key
beeper-steipete
Source
github.com/steipete/agent-scripts