Hush logo

Hush

Telegram as plain text in your Mac menu bar. A list of chats, one conversation, one box to type in. Agents get the same text through MCP.

Download Source on GitHub
Hush popover listing chatsHush popover listing chats, dark A conversation as plain text linesA conversation, dark

What it is

Quiet

One dot in the menu bar: filled when something unread is waiting, outlined when you are caught up. No badges, no sounds. Star a chat to get banners for it only, and a stack view of its unread messages.

Plain text

Chats, lines, one box. Photos and files show as a marker like [photo] and are never downloaded. No stickers, search, replies or forwards.

Light

About 4 MB. Telegram pushes updates, so nothing polls. The interface is destroyed when closed and no message database is kept.

Agent friendly

A built-in MCP server lists chats, reads messages and, with your approval every time, sends.

Favorites stack

The favorites stack: a deck of cards for unread favorite chatsThe favorites stack, dark

A focus view for the chats you starred. Press Ctrl+Option+S from any app and read what is new, one card at a time, newest on top.

OptionDoes
Move↓ → next card, ↑ ← previous. Scroll, swipe or click a card behind also works. It does not wrap.
ReplyReturn or click Reply, type, Return to send. The card is cleared when sent.
DoneD or click Done to mark the chat read without replying.
CloseEsc, the close button, or the shortcut again. While typing, the first Esc leaves the box and keeps your draft.
ShortcutChange it in Settings, Shortcuts. Conflicting shortcuts are rejected.
LiveNew favorite messages join the open stack. While you reply, new chats wait so the card you are on never moves.
AccessibleVoiceOver actions for next, previous, reply, mark read and close. Reduced motion is respected.

Install

curl -fsSL https://raw.githubusercontent.com/kalahroudi/hush/main/scripts/install.sh | bash

Setup downloads TDLib (Telegram's official library) into Hush's own folder, no Homebrew needed, and asks for a free API ID and hash from my.telegram.org/apps. Then sign in with your phone number.

If you download the DMG in a browser, macOS blocks the first launch because Hush is not notarized yet. Open Hush once, then go to System Settings, Privacy & Security, and click Open Anyway. The install command above avoids this.

Keyboard

KeysDoes
↑ ↓Move the highlight in the chat list. Stops at the first and last chat.
ReturnOpen the highlighted chat. In the message box it sends.
Tab Shift+TabOpen the next or previous chat, wrapping at the ends. Works while typing. In the popover, Tab opens the first chat and Shift+Tab the last.
Ctrl+Option+SOpen the favorites stack from anywhere: one card per favorite chat with unread messages, newest on top. Press it again to close.
↓ → ↑ ← EscIn the stack, go to the next or previous card without wrapping. Esc closes it.

For agents

ToolDoesChanges anything
hush_statusSigned-in account, unread countno
hush_list_chatsChats with last line and unreadno
hush_readLatest messages of a chat, without marking them readno
hush_sendSends as youasks you every time
claude mcp add hush --scope user -- /Applications/Hush.app/Contents/MacOS/hush-mcp

Settings

SettingsSettings, dark Agents settings