Glitched-out terminal Meshtastic messenger.

An irssi-style chat client for your LoRa radio with a vintage BBS aesthetic — maxheadroom palette, ░▒▓█ glitch borders, BitchX-style rotating splash, mutt-grade keyboard, and ham-radio slash-commands baked in.

• 📡 Connects to your Meshtastic radio over USB serial, TCP, or Bluetooth LE
• 🔵 Bluetooth LE workflow — meshx ble scan / pair / list / connect / fav to save multiple radios by uuid or friendly name and switch between them without re-pairing
• ⌨️ irssi-style modal UI — input always live, Esc drops to scrollback nav
• 📜 mutt-grade message log — dense one-row-per-message, zebra-striped, j/k walks
• 📻 Ham-radio slash-commands — /cq, /73, /qth, /rs, /qrz, /sk, /mesh, + 9 more
• 👥 BitchX-style bracketed users grid — [ @KC7XYZ ] tiles with IRC sigils
• 🌈 Maxheadroom 80s-neon palette — cyan / mesh-green / magenta / pink, matches grind + tlock
• 🎨 BitchX-style rotating ASCII splash — different graffiti logo every launch
• 🔍 Live / search across log / channels / users with n / N cycling
• ⇥ Tab completion — commands, #channels, nicks; irssi nick-addressing quirk included
• 📌 Stable tmux-pane channel tabs + Alt+1..4 quick-hop
• ❓ Scrollable ? help overlay — every keybinding and command, vim-scrollable
• 💾 bbolt-backed history — message log, node cache, and paired BLE devices survive restarts (~/.meshx/meshx.bolt)

curl -fsSL https://github.com/retr0h/meshx/raw/main/install.sh | sh

Installs to ~/.local/bin (or /usr/local/bin as root) — SHA256 checksums verified. Override with MESHX_INSTALL_DIR=/some/path or pin a version with MESHX_VERSION=1.1.1.

git clone https://github.com/retr0h/meshx.git
cd meshx
go build -o meshx .
install -m 755 meshx ~/.local/bin/meshx

meshx           # auto-connect to a plugged-in radio (USB → saved BLE)
meshx --help    # usb, tcp, ble subcommand trees

Full command + keybinding reference in docs/commands.md.

meshX is a Meshtastic client. It connects to a radio you already own (T-Beam, Heltec, RAK, Station G2, etc.) over one of three transports and reads the mesh:

1. USB serial (default) — plug the radio in; auto-detect port
2. TCP — radios with WiFi expose port 4403, or connect to meshtasticd
3. Bluetooth LE — meshx ble pair <uuid> saves a device, then meshx ble connect <name> opens the TUI over Bluetooth

All three speak Meshtastic's protobuf protocol and funnel through one Client interface, so the UI is oblivious to which transport's carrying the packets. meshX subscribes to FromRadio, emits ToRadio for sends, and surfaces everything in a scrollable terminal chat UI with vim/irssi ergonomics.

Every report (/rs, /ping, /tr, /whois) pulls from node state that maps 1:1 to real Meshtastic protobuf fields.

meshX sits at the intersection of three lineages:

• irssi — the input-first modal UI, the /command dispatcher, and the stable bottom status line with channel tabs come straight from irssi. Alt+n channel hop too.
• BitchX — the rotating graffiti ASCII splash (different logo every launch), the bracketed [ @nick ] users grid, and the unapologetic neon palette are pure BitchX. (RIP caf.)
• mutt — the dense one-row-per-message log, j/k scrollback nav, r reply on selection, and the modal input ↔ nav distinction come from mutt.
• vim — every window scrolls with j/k/h/l/gg/G/Ctrl+D/Ctrl+U, Ctrl+W for window nav, / + n/N for search.
• tmux — Ctrl+N / Ctrl+P channel cycle and the giant flash-digit pane picker.
• grind, tlock — sibling retr0h projects; meshX reuses their maxheadroom palette, ░▒▓█ block-border language, and block-art primitives.

• 🔑 PSK import — /channel add <meshtastic://url> paste a shared-channel link and join without manually typing the PSK
• 📱 QR code share — /channel share <name> emits the meshtastic:// URL as ASCII QR for phone-side scanning
• 🔒 Channel mint + delete — /channel new <name> generates a random AES256 PSK locally and pushes via AdminMessage_SetChannel; /channel del <name> disables a slot
• 🎨 Low-color fallback palette — detect $COLORTERM / $TERM and swap hex values for 16-color ANSI when the terminal doesn't support 24-bit color

• docs/commands.md — every keybinding and slash-command, with the Meshtastic API call each command makes
• docs/development.md — architecture, setup, testing
• docs/contributing.md — PR workflow

The MIT License.