Agent skill

Beeper

by steipete in steipete/agent-scripts

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

MITAuto-check passedProductivity & Automation

Install Beeper

skills CLI
$ npx skills add steipete/agent-scripts --skill beeper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/agent-scripts beeper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/agent-scripts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/beeper .claude/skills/beeper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
beeper
GitHub stars
7.3k
Token cost
~250 tokens
SKILL.md length
71 words
Files
1
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Identify likely account/bridge/room from… → Use FTS for text discovery. → Narrow by date, participant, and room. → …
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers Source and Workflow
  • Calls sqlite3

What it does

Beeper is an agent skill from steipete/agent-scripts. Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

Its SKILL.md is about 250 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Messaging and chat bots. It works with WhatsApp. The repository describes itself as: Scripts for agents, shared between my repositories. The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots

Example prompts

  • “/beeper”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 79150cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • sqlite3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Beeper loads about 250 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 71 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~250

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from steipete/agent-scripts at commit 79150cf, republished under its MIT licence (© steipete). 71 words, ~250 tokens.

Download SKILL.mdSave it as .claude/skills/beeper/SKILL.md (or your agent's skills folder).
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/beeper of steipete/agent-scripts.

Open the folder on GitHubat commit 79150cf

Compare with similar skills

Beeper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Beeper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Beeper this skillsteipete/agent-scripts7.3k—~250Automated safety check: PassMIT
Ak Dev New Messaging Integrationyaalalabs/agent-kernel191—~4.2kAutomated safety check: PassApache-2.0
Whatsapp Automationdavepoon/buildwithclaude3.6k7 repos~2.1kAutomated safety check: PassMIT
C Messagingdaxaur/openpaw173—~568Automated safety check: PassMIT
Books And RecordsJoelLewis/finance_skills205—~11kAutomated safety check: PassMIT
Ak Add Integrationyaalalabs/agent-kernel191—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Ak Dev New Messaging Integration

    yaalalabs/agent-kernel

    Step-by-step guide for adding a new messaging platform integration to Agent Kernel.

    191 GitHub stars~4.2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Whatsapp Automation

    davepoon/buildwithclaude

    Automate WhatsApp Business tasks via Rube MCP (Composio): send messages, manage templates, upload media, and handle contacts.

    3.6k GitHub starsUsed in 7 repos~2.1k tokens
    Productivity & AutomationAuto-check passed
  • C Messaging

    daxaur/openpaw

    Send and read messages via imsg (iMessage) and wacli (WhatsApp).

    173 GitHub stars~568 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Books And Records

    JoelLewis/finance_skills

    Guide the design and maintenance of recordkeeping programs under SEC Rules 17a-3, 17a-4, and 204-2.

    205 GitHub stars~11k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Ak Add Integration

    yaalalabs/agent-kernel

    Add a messaging platform integration to an existing Agent Kernel project.

    191 GitHub stars~2.6k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Ecom Conversational

    asgard-ai-platform/skills

    Design conversational commerce experiences across messaging platforms including chatbot flows, product cards, and conversion strategies.

    241 GitHub stars~1.2k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed

More from steipete/agent-scripts

All 45 skills in this repo
  • Mac Fleet Maintenance

    steipete/agent-scripts

    Inventories and maintains a fleet of Macs from a desired-state file: package updates, repo and Xcode sync, and disk, backup and security health reports.

    7.3k GitHub stars~4.8k tokensUpdated 2 days ago
    Auto-check passed
  • Agent Transcript for PRs

    steipete/agent-scripts

    Finds a coding agent's session log, trims and redacts it, and inserts it into a GitHub PR or issue only when the user has asked for a transcript.

    7.3k GitHub starsUsed in 1 repo~698 tokens
    Auto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • ClawSweeper Status

    steipete/agent-scripts

    Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

    7.3k GitHub stars~972 tokensUpdated 2 days ago
    Auto-check passed
  • GitHub Project Triage

    steipete/agent-scripts

    Produces maintainer-facing triage cards for a project's GitHub issues and pull requests, each with its URL, risk, test state, blockers and a next action.

    7.3k GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed
  • Nano Banana Image Generation

    steipete/agent-scripts

    Generates and edits images with Google's Nano Banana 2 (Gemini 3.1 Flash Image) through a uv script, with a draft-then-final workflow and sizes from 512 to 4K.

    7.3k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Beeper

What does Beeper do?

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS. Beeper is an agent skill from steipete/agent-scripts. Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

When should I use Beeper?

Beeper fits situations like: tasks that involve Messaging and chat bots.

How do I install Beeper in Claude Code?

Run `npx skills add steipete/agent-scripts --skill beeper -a claude-code`. Or copy the skill folder (skills/beeper in steipete/agent-scripts) into .claude/skills/beeper in your project. Claude Code loads it when a task matches its description.

How do I install Beeper in Codex?

Run `npx skills add steipete/agent-scripts --skill beeper -a codex`. Or copy the skill folder (skills/beeper in steipete/agent-scripts) into .agents/skills/beeper in your project. Codex loads it when a task matches its description.

Can I use Beeper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/agent-scripts --skill beeper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/beeper, .gemini/skills/beeper, .github/skills/beeper and .opencode/skills/beeper in your project.

What does Beeper need to run?

Going by SKILL.md and its folder, Beeper needs the command-line tools its instructions call (sqlite3).

Does Beeper access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Beeper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Beeper use?

Beeper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Beeper use?

About 250 tokens (SKILL.md is roughly 1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Beeper?

Skills that share tags, products or a category with Beeper: Ak Dev New Messaging Integration (yaalalabs/agent-kernel, 191 stars), Whatsapp Automation (davepoon/buildwithclaude, 3.6k stars), C Messaging (daxaur/openpaw, 173 stars) and Books And Records (JoelLewis/finance_skills, 205 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Beeper?

steipete (a GitHub user) maintains it in steipete/agent-scripts, which has 7,259 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 4, 2026.

Source: steipete/agent-scripts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.