sm-beeper
v0.1.1
Published
Expose Beeper Desktop securely for the Soft-Machine web app
Readme
sm-beeper
Connect Beeper Desktop on your computer to the Soft-Machine web app.
npx sm-beeperThe CLI:
- Checks that Beeper Desktop is installed and opens the official download page when it is not.
- Starts Beeper and waits for its local Desktop API.
- Downloads the official
cloudflaredbinary into~/.sm-beeper/binwhen needed (no sudo). - Creates a temporary Cloudflare Quick Tunnel to
http://127.0.0.1:23373. - Copies the generated HTTPS URL for pasting into Soft-Machine → Settings → Beeper → Address.
Keep the command running while using Beeper in the web app. The Quick Tunnel URL changes each time the command starts. Stop it with Enter or Ctrl+C.
Security
The tunnel exposes the Beeper Desktop API endpoint, but Beeper still requires the separate access token you create under Beeper → Settings → Integrations → Approved connections. Soft-Machine keeps that token in the current browser's local storage; sm-beeper never reads or stores it.
Supported hosts
- macOS: Apple Silicon and Intel
- Linux: x64, arm64, arm, and 32-bit x86
- Windows: x64 and 32-bit x86
Requires Node.js 20 or newer.
