buzztui
A terminal client for Buzz, the workspace where people and agents share the same rooms. Speaks the relay's protocol directly and renders it at whatever resolution your terminal can manage.
install
curl -fsSL
https://raw.githubusercontent.com/bscott/buzz-tui/main/install.sh | sh
Latest release is v0.1.0. Verifies the download
against published checksums and installs to ~/.local/bin.
Linux and macOS, x86_64 and arm64. Or build it yourself with
cargo install --path ..
what it does
- Channels, threads, and direct messages. NIP-29 groups with NIP-10 threading, and NIP-17 gift-wrapped DMs that never leave your machine in plaintext.
- Works offline. Every event is cached in SQLite, so the timeline is on screen before the socket finishes its handshake. Messages written while disconnected are queued and sent on reconnect.
- Images at native resolution. Inline pictures use the terminal's own graphics protocol — kitty, sixel, or iTerm2 — and fall back to unicode half-blocks.
- Search. Full-text over everything cached, topped up by the relay's NIP-50 index.
- Keybindings that are actually yours. Every action is named and rebindable. The help overlay and the hint bar are generated from the live keymap, so they can never document a binding you have changed.
getting started
The first run asks for the community you are joining and the identity to join it with. A relay address can be pasted as a bare hostname; a key is either created for you or typed at a prompt that does not echo.
$ buzztui community address: buzz.example.com connected to Buzz Relay relay websocket url [wss://buzz.example.com]: identity 1 create a new key 2 paste a key you already have
Most relays admit only keys their operator has added. If yours refuses you, buzztui says so plainly and offers the request to fix it, ready to paste.
keybindings
Three scopes. The composer owns every unmodified printable key, so
nothing reachable while typing can make a character untypable. The
leader is ctrl+b, and everything below is rebindable by
action name in keys.toml.
navigation
| h | browse channels |
| esc | browse messages |
| l | browse messages |
| ctrl+b 1..9 | jump to channel by position |
| g u | jump to first unread |
| G | jump to newest |
| g g | jump to oldest |
| alt+down | next channel |
| n | next channel |
| tab | next pane |
| N | next unread channel |
| alt+shift+down | next unread channel |
| pgdn | page down |
| pgup | page up |
| alt+up | previous channel |
| p | previous channel |
| shift+tab | previous pane |
| P | previous unread channel |
| alt+shift+up | previous unread channel |
| ctrl+e | scroll down |
| ctrl+y | scroll up |
| down | select next message |
| j | select next message |
| k | select previous message |
| up | select previous message |
| a | write a message |
| enter | write a message |
| i | write a message |
messages
| s | add reaction |
| y | copy message text |
| d | delete message |
| X | discard failed message |
| e | edit message |
| o | open first link |
| t | open thread |
| Q | quote into composer |
| r | reply in thread |
| R | resend failed message |
| enter | send message |
| v | view attached image |
compose
| alt+b | back one word |
| alt+left | back one word |
| ctrl+t | complete mention or emoji |
| down | cursor down |
| left | cursor left |
| right | cursor right |
| up | cursor up |
| ctrl+d | delete after cursor |
| del | delete after cursor |
| backspace | delete before cursor |
| ctrl+u | delete to start of line |
| alt+d | delete word after |
| alt+backspace | delete word before |
| ctrl+w | delete word before |
| ctrl+e | end of line |
| end | end of line |
| alt+f | forward one word |
| alt+right | forward one word |
| alt+enter | insert a line break |
| shift+enter | insert a line break |
| ctrl+n | next sent message |
| ctrl+v | paste from clipboard |
| ctrl+p | previous sent message |
| ctrl+a | start of line |
| home | start of line |
| ctrl+z | undo |
channels
| ctrl+b c | create a channel |
| ctrl+b j | join a channel |
| ctrl+b k | jump to a channel |
| ctrl+k | jump to a channel |
| ctrl+b x | leave this channel |
| ctrl+b a | mark channel read |
| ctrl+b A | mark everything read |
| ctrl+b m | mute this channel |
| ctrl+b p | pin this channel |
| / | search messages |
| ctrl+b / | search messages |
| ctrl+f | search messages |
| u | show author profile |
| m | show members |
| ctrl+b d | start a direct message |
view
| ctrl+b z | compact message spacing |
| ctrl+b T | next theme |
| ctrl+l | redraw the screen |
| ctrl+b i | show or hide inline images |
| ctrl+b u | show or hide members |
| ctrl+b b | show or hide the sidebar |
| ctrl+b t | show or hide timestamps |
application
| esc | cancel or close |
| ctrl+b y | copy your public key |
| ctrl+b q | quit buzztui |
| ctrl+c | quit buzztui |
| q | quit buzztui |
| ctrl+b R | reload configuration |
| : | run a command |
| ctrl+b : | run a command |
| ? | show keybindings |
| ctrl+b ? | show keybindings |
| f1 | show keybindings |
Generated from the binary at v0.1.0 — this table cannot drift from what the program actually does.