cyberdeck

A 13-screen ratatui TUI + axum web bridge for the ClockworkPi uconsole.
City map with braille POI/area rendering, weather icons, GPS marker, AI assistant,
two-pane WM with live PTY terminals, Wi-Fi radar with human sensing.

---

What it is

A rich TUI + LAN web UI for OS-level control of a single-board computer — designed for the ClockworkPi uconsole (aarch64, Debian 13 trixie).

+------------------+   +-----------------+   +----------------+
|  cyberdeck-core  |<--|  cyberdeck-tui  |   |  cyberdeck-web |
|  (no TUI/web)    |   |  ratatui front  |<->|  axum HTTP/WS  |
+------------------+   +-----------------+   +----------------+

• cyberdeck-core — async wrappers for nmcli, systemctl, apt, pactl, bluetoothctl, etc.
• cyberdeck-tui — 13 screens + city map + AI + command palette + window manager with live terminals.
• cyberdeck-web — axum 0.7 server (JSON API + WebSocket). Standalone or embedded in the TUI.
• wifi-radar — passive 802.11 monitor with CSI human sensing and a web UI.

Quick install

# TUI only
curl -fsSL https://raw.githubusercontent.com/ankurCES/uconsole-cybertui/main/install/install.sh \
  | bash -s -- --tui

# TUI + web service
curl -fsSL https://raw.githubusercontent.com/ankurCES/uconsole-cybertui/main/install/install.sh \
  | bash -s -- --full

See docs/installation.md for all presets, options, and build-from-source.

Quick run

cyberdeck-tui                          # TUI
cyberdeck-tui --web                    # TUI + embedded web (0.0.0.0:7878)
cyberdeck-web 0.0.0.0:7878             # standalone web
cargo run -p wifi-radar -- --dev       # Wi-Fi radar (dev mode)

Documentation

Document	Contents
Installation	One-liner install, presets, options, build from source
Screens & Keymaps	TUI screens, navigation, global keys, WM keys, HTTP API
Configuration	Privilege model, sudoers, bearer tokens
Development	Architecture, hardening, contributing

Wiki

Page	Topic
Home	Index
Architecture	Crate map, action flow
Keymaps	Full per-screen keymap
Hardware / Setup	uconsole on Debian 13
WiFi Vitals	CSI human sensing setup
Hardening	No-hang PTY tests
Roadmap	Phases + follow-ups

License

MIT.

---

_{clockworkpi · uconsole · aarch64 · rust · ratatui · axum · tui}