Skip to content
Get packs

Beeper Chat History Search

Search your local Beeper message cache to find chats across iMessage and WhatsApp.

Source Download skill
Repository
steipete/agent-scripts
Stars
7,433
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent to look through the local message database that the Beeper chat app keeps on a Mac. When you give a vague hint about a person or conversation, the agent first lists accounts and chat rooms, then runs full-text searches over messages, narrows by date and participant, and reports which chat, bridge (such as iMessage or WhatsApp) and date range it likely means, with a confidence level. It is meant for local, private history lookups rather than sending messages.

Great for

  • People who use Beeper to combine iMessage and WhatsApp and want to find an old conversation from a vague memory
  • Users on macOS who want an agent to search their own local Beeper history

Skip it if

  • Anyone who wants to send or edit messages, since the skill only reads a local database (it can be risky to share results beyond your own machine because the database holds private messages)
  • Non-Mac users or people without the Beeper app, because the database path is specific to a macOS Beeper install

Try asking

  • “Find the WhatsApp chat where someone mentioned a dentist appointment sometime last spring”
  • “Which iMessage thread did I discuss the apartment lease in, and what dates?”
  • “Search my Beeper history for messages containing 'flight confirmation' and tell me which room they're in”
Step-by-step guide: how to use Beeper Chat History SearchInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    beeper.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip beeper.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip beeper.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for a vague hint with any names, rough dates or bridge names; the agent will narrow it down from accounts and rooms first.
  • Review the agent's reported room names and date spans, since matches are based on text and may be imperfect.
  • Keep the conversation local and avoid pasting extracted private messages into shared or cloud tools unnecessarily.

What's inside

  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.