# Send Beeper CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "beeper-cli",
    "name": "Beeper CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/foeken/beeper-cli",
    "canonicalUrl": "https://clawhub.ai/foeken/beeper-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/beeper-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beeper-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "beeper-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T12:00:28.949Z",
      "expiresAt": "2026-05-07T12:00:28.949Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beeper-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=beeper-cli",
        "contentDisposition": "attachment; filename=\"beeper-cli-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "beeper-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/beeper-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/beeper-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/beeper-cli",
    "agentUrl": "https://openagent3.xyz/skills/beeper-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/beeper-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/beeper-cli/agent.md"
  }
}
```
## Documentation

### beeper

Use this skill when you need to search chats, list/read messages, or send messages via Beeper Desktop.

### What this is

A CLI wrapper around the Beeper Desktop API. No MCP, no curl — just beeper commands.

Requires beeper-cli.

### Prereqs

Beeper Desktop running with API enabled: Settings > Developers
beeper-cli installed
Env var: BEEPER_ACCESS_TOKEN set (get from Beeper Desktop: Settings > Developers > API Access Token)

### Install beeper-cli

Download from releases, or build:

go install github.com/foeken/beeper-cli@latest

### Accounts

beeper accounts list
beeper accounts list -o table

### Chats

# List all chats (sorted by last activity)
beeper chats list

# Search chats
beeper chats search --query "John"
beeper chats search --query "project" --type group

# Get specific chat
beeper chats get "<chatID>"

# Archive
beeper chats archive "<chatID>"

# Create
beeper chats create --account-id "telegram:123" --participant "user1" --type dm

# Reminders
beeper chats reminders create "<chatID>" --time "2025-01-26T10:00:00Z"
beeper chats reminders delete "<chatID>"

### Messages

# List messages in a chat
beeper messages list "<chatID>"

# Search messages
beeper messages search --query "dinner"
beeper messages search --query "dinner" --limit 10
beeper messages search --query "meeting" --sender me
beeper messages search --query "budget" --after "2025-01-01T00:00:00Z"
beeper messages search --chat-ids "<chatID>" --media-type image

# Send a message
beeper messages send "<chatID>" "Hello!"

# Send with reply
beeper messages send "<chatID>" "Thanks!" --reply-to "<messageID>"

# Edit a message
beeper messages edit "<chatID>" "<messageID>" "Corrected text"

### Assets (attachments)

# Upload a file
beeper assets upload /path/to/image.png

# Download an asset
beeper assets download "mxc://beeper.local/abc123" --output /path/to/save.jpg

# Send with attachment (upload first)
beeper assets upload /path/to/photo.jpg  # returns uploadID
beeper messages send "<chatID>" "Check this!" --upload-id "<uploadID>"

### Other

# Focus Beeper window
beeper focus
beeper focus --chat-id "<chatID>"

# Global search
beeper search "important"

### Output formats

beeper chats list -o json   # default
beeper chats list -o table  # human-readable

### Workflow

Find the chat: beeper chats search --query "Name"
Read messages: beeper messages list "<chatID>"
Search content: beeper messages search --query "phrase"
Send: beeper messages send "<chatID>" "message"

### Safety

Store BEEPER_ACCESS_TOKEN securely (e.g., in a password manager)
When quoting messages, include only what's needed
Confirm message text before sending unless explicit
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: foeken
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T12:00:28.949Z
- Expires at: 2026-05-07T12:00:28.949Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/beeper-cli)
- [Send to Agent page](https://openagent3.xyz/skills/beeper-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/beeper-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/beeper-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/beeper-cli)