Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add steipete/agent-scripts --skill beeper -a claude-code
Open on GitHub

What 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_fts for 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-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/beeper/

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

Similar skills

All skills for Data and databases →

From the same set20

The whole set →
discord-clawd discord-clawd — a skill to send questions to a Discord-backed agent via OpenClaw relay. Not for archive search—use it to communicate directly with a live session. CX Codex +1 122installs openclaw-relay openclaw-relay is a Claude Code skill that routes prompts and messages to OpenClaw sessions via local acpx or SSH, resolving targets from named aliases in config/session_aliases.json. CX Codex +1 120installs mac-maintenance mac-maintenance automates macOS maintenance by upgrading Homebrew packages, pulling clean git repositories, and emptying the Trash. CX Codex +1 117installs cloudflare-registrar A skill to check domain availability in Cloudflare Registrar, retrieve pricing, and register domains from your code editor. Use it when you register domains regularly and want to skip the dashboard. CX Codex +1 108installs codex-debugging codex-debugging guides debugging across the codex-rs repository. Essential when investigating runtime bugs, CLI behavior, or config parsing issues. CX Codex +1 108installs github-project-triage The github-project-triage Claude Code skill reviews open GitHub issues and pull requests when prompted with “triage.” It surfaces blockers, checks, risks, and a next action for each item. CX Codex +1 105installs obsidian A skill for Claude Code searches, reads, and edits local Obsidian vaults. It handles requests involving notes, backlinks, Bases, and Canvas. CX Codex +1 104installs openai-image-gen openai-image-gen — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode: calls the OpenAI Images API, renders a batch of images from structured prompts, and builds an HTML gallery. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open