beeper-cli

Query Beeper's local SQLite database to list threads, read messages, and search.

32|1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/KrauseFx/beeper-cli --skill beeper-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beeper-cli
Source: https://github.com/KrauseFx/beeper-cli/tree/main
Command: npx skills add https://github.com/KrauseFx/beeper-cli --skill beeper-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a safe, read-only way to explore Beeper chat history stored in SQLite without risking data modification.

Core Features & Use Cases

  • List threads and conversations with metadata
  • Read messages with full metadata and optional JSON output
  • Full-text search (FTS5) with graceful fallback and attachment metadata
  • Resolve DM/contacts names via optional bridge databases
  • Output is suitable for automation and agent integration via JSON

Quick Start

Run the beeper-cli binary to list threads, read messages, and perform searches on your local Beeper database.

Frequently Asked Questions about beeper-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read Beeper chat history from the local SQLite database?

You can read Beeper chat history by running the beeper-cli binary to access the local index.db file, listing threads and reading messages with full metadata directly from the SQLite data.

Can I search Beeper messages from the terminal using full-text search?

Yes, you can search Beeper messages from the terminal using FTS5 full-text search, which includes attachment metadata and provides a graceful fallback if the search index is unavailable.

Is there a read-only way to browse local Beeper conversations safely?

Yes, beeper-cli provides a safe, read-only way to browse local Beeper conversations and explore chat history stored in SQLite without risking any data modification.

How do I get JSON output from Beeper messages for automation?

You can get JSON output from Beeper messages by running the read commands with optional JSON output formatting, making the extracted message data suitable for automation and agent integration.

Do I need optional bridge databases to resolve DM contact names in Beeper?

You need optional bridge databases to resolve DM and contact names in Beeper, as the tool works with the default index.db location but requires these additional databases for name resolution.