sst - Simple Signal TUI
A terminal client for Signal. For people who live in the shell and want to read, send, and script Signal messages without a desktop GUI.
Alice Wagner
────────────────────────────────────────────
Alice Wagner 09:14
Hey, are you free tonight?
You 09:31
Sure, sounds good! ✓✓
[2x❤️, 1x👍]
────────────────────────────────────────────
j/k navigate r reply e edit d delete : command q back
-- NORMAL --
Features
- Vim-modal chat — Normal / Insert / Command modes, colon commands (
:react,:quit). - Full message flow — reply, edit, delete-for-everyone, reactions, read receipts.
- Contact browser — start a chat with anyone synced, not just existing threads.
- Attachments — stage, upload, and download files.
- Scriptable CLI —
send,print,watch, and more with text or JSON output. - Local SQLite store — messages and session keys live on disk, no server round-trip to read.
Getting started
- Build and install:
make install(puts the release binary in~/.bin/sst). - Link to your phone:
sst link— scan the QR code from Signal → Settings → Linked Devices → Link New Device. - Run
sstto open the TUI.
Data lives in ~/.local/share/sst (store, session keys, sst.log, the sst.sock send socket). Set
RUST_LOG=debug for verbose logging.
Keybindings
Chat list and contact browser:
| Key | Action |
|---|---|
j k ↑ ↓ |
Navigate |
l / Enter / → |
Open chat |
n |
Contact browser (chat list only) |
h / Esc / ← |
Back |
Q |
Quit |
Chat window (Normal mode):
| Key | Action |
|---|---|
j k |
Select newer / older message |
i |
Compose (Insert mode) |
r / e |
Reply / edit selected message |
dd |
Delete selected own message for everyone |
: |
Command mode |
h / q / ← |
Back to chat list |
Insert mode: Enter sends, Alt+Enter inserts a newline, Tab completes an @Name
mention (delivered as a real Signal mention, so that member gets notified), Esc
discards. Command mode: :react <emoji> (raw emoji or gemoji shortcode like
wave), :quit.
CLI
sst runs non-interactively for scripting. send hands the message to a running
TUI or watch over a local socket, or sends directly when nothing else is running.
chats, contacts, print, print-last and recent read the local store beside a running
instance and sync first when nothing else is running; watch holds the session.
| Command | Description |
|---|---|
sst link |
Re-link via QR code (wipes existing session) |
sst chats |
List threads, most recent first |
sst contacts |
List known contacts and groups |
sst print <ID> |
Print full chat history |
sst print-last [-n N] <ID> |
Print the last N messages |
sst recent [--since WHEN] [--mentions-me] [-n N] |
Messages from others across all chats since a time (default 24h); --mentions-me keeps only @-mentions of you |
sst watch <ID> |
Stream new incoming messages |
sst send <ID> [TEXT] [--attach PATH]… |
Send a message (text or stdin) |
<ID> is a contact UUID or 64-char hex group master key (from sst contacts).
Add --format=json for NDJSON output, or --db <PATH> to override the store location.
JSON records, one per line. Timestamps are RFC 3339, to the millisecond. These fields are an interface other tools parse; renaming one is a breaking change.
| Command | Fields |
|---|---|
chats |
id, name, preview, timestamp, unread |
contacts |
id, name, type (contact or group) |
print, print-last, watch |
timestamp, sender_uuid, sender_name, body; watch adds edit_of on an edit |
recent |
the message fields plus chat_id, chat_name, mentions_me |