beeper — Claude Code skill: what it does, how to install
beeper is a Claude Code skill that searches local Beeper history. It resolves vague contact clues across iMessage and WhatsApp bridges.
MIT 104 installs ★ 7,554 updated 2026-10-20
npx skills add steipete/agent-scripts --skill beeper -a claude-codeWhat beeper does
The beeper skill searches local Beeper history for contacts, rooms, and message text. It first identifies a likely account, bridge, or room from accounts, participants, and room tables, then uses that context to narrow the search.
Text lookup runs through the mx_room_messages_fts table. Results can be filtered by date, participant, and room, with the report including room and account names, date spans, and confidence. It needs the database at ~/Library/Application Support/BeeperTexts/index.db and the sqlite3 command. The database may contain private messages, so results stay local.
What it helps with
- find a room from a vague contact clue
- connect a conversation to an iMessage or WhatsApp bridge
- search message text through FTS
- narrow matches by date and participant
- report the room, account, date span, and confidence
Example prompts for the agent
- Search local Beeper history for a conversation matching this contact clue: “...”
- Identify the account, bridge, and room for the WhatsApp messages, then narrow the results by date.
- Search
mx_room_messages_ftsfor mentions of “...” and report the date span and confidence.
How to install beeper
1Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill beeper -a claude-code2Manually: put the files in place
~/.claude/skills/beeper/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/beeper/
1Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill beeper -a codex2Manually: put the files in place
.agents/skills/beeper/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill beeper -a cursor2Manually: put the files in place
.cursor/skills/beeper/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install steipete/agent-scripts skills/beeper2Manually: put the files in place
.github/skills/beeper/SKILL.md1Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill beeper -a gemini-cli2Platform CLI
gemini skills install https://github.com/steipete/agent-scripts --path skills/beeperManually: put the files in place
.devin/skills/beeper/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill beeper -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about beeper
How do I install beeper in Claude Code?
Run npx skills add steipete/agent-scripts --skill beeper -a claude-code, then use ~/.claude/skills/beeper/SKILL.md.
What does beeper do?
It searches local Beeper messages by contact, room, and text. The skill identifies an account or bridge, uses FTS, narrows matches by date and participant, and reports confidence.
What does beeper need to work?
It needs the local database at ~/Library/Application Support/BeeperTexts/index.db and the sqlite3 command. The database supplies the Beeper room and message records used by the search.
Source text
SKILL.md · MIT
--- name: beeper description: "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: ```bash sqlite3 "$HOME/Library/Application Support/BeeperTexts/index.db" \ "select * from accounts limit 20;" ``` ```bash 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.
© steipete · MIT · steipete/agent-scripts