open source · MIT · v0.x
Your whole inbox. In your terminal.
A fast, keyboard-first TUI for your Beeper unified inbox. WhatsApp, Slack, Telegram, Signal, Discord and more — read, search and reply without leaving the terminal.
Requires Beeper Desktop running locally. macOS tested; Linux via binary.
// what is beeptui
beeptui is a terminal client for the Beeper Desktop API running on your own machine. Beeper stays the account, sync and encryption boundary — beeptui is just a fast, keyboard-first window into it. Not a bridge, not a Matrix client, not another messaging service.
//why you'd want it
One inbox, every network
WhatsApp, Slack, Telegram, Signal, Discord, Instagram and X DMs in a single rail. Cycle networks with [ and ] — one keyboard for all of it.
Live, without a refresh key
WebSocket updates land while you read. Your scroll position holds, your draft survives, nothing flickers. It just stays current, the way a chat client should.
Everything is a keystroke
? opens the help overlay. / fuzzy-filters the inbox, S searches history, U shows unread only. q quits, like it should.
Replies, reactions, edits
Threaded replies, reactions, edits and read receipts — sent for real.
Drafts that survive
Compose is persisted as you type. A crash never eats a message.
Local and private
Talks only to your own Beeper endpoint. No telemetry. Tokens live in the OS keychain, never a config file.
tmux and SSH friendly
Behaves in a pane, with an unread indicator for your status bar.
Themeable, rebindable
Per-network accent colours, custom keybinds, comfortable or compact density.
doctor
One command checks your endpoint, token and terminal before first run.
// install
Download for your OS from GitHub Releases, verify against sha256sums.txt, then:
First run: create a token in Beeper Desktop → Settings → Integrations → Approved connections, then run beeper-tui doctor to check everything. Full setup in the README.
// docs
// open source
Built by @mitchmalone because I wanted more of the tools I love in the terminal. MIT licensed. Issues and PRs genuinely welcome.