API Reference

Client

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Focus Beeper Desktop app

$ beeper-desktop-cli focus

POST/v1/focus

Focus Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment.

ParametersExpand Collapse

--chat-id: optional string

Optional Beeper chat ID (or local chat ID) to focus after opening the app. If omitted, only opens/focuses the app.

--draft-attachment-path: optional string

Optional draft attachment path to populate in the message input field.

--draft-text: optional string

Optional draft text to populate in the message input field.

--message-id: optional string

Optional message ID. Jumps to that message in the chat when opening.

ReturnsExpand Collapse

FocusResponse: object { success }

Response indicating successful app focus action.

success: boolean

Whether the app was successfully opened/focused.

Focus Beeper Desktop app

CLI Tool

HTTP

TypeScript

Python

Go

CLI Tool

PHP

beeper-desktop-cli focus \
  --access-token 'My Access Token'

200 example

{
  "success": true
}

Returns Examples

200 example

{
  "success": true
}