Repository navigation
Terminal Experience
Status: design proposal. There are no application screenshots yet.
Calm, readable and compact: neutral borders, cyan activity, amber input requests, green completion and red errors. Colour always has a text label and optional icon. Use native terminal colours and capability detection instead of assuming truecolour, Unicode or an 80-column window. Escape untrusted text before Spectre markup rendering.
A header shows host health and the active profile. Device rows show aliases, transport, observed state and last successful transmission. Session rows show project, integration, activity and last observation. A bounded event list explains changes and delivery failures. Expanded details reveal raw metadata only on request.
Render with Spectre.Console live output. Whether navigation uses a selection-menu shell or a fully live key-driven view needs a prototype; Spectre.Console is not a complete desktop-style terminal UI framework.
- Overview: device/session activity and recent events.
- Devices: pairing QR/token, aliases, test pattern and connection diagnosis.
- Integrations: install, doctor, repair and remove hooks.
- Animations: select, preview, edit, validate and assign per-state programs.
- Settings: profiles, brightness, startup and opt-in migration.
spn
spn link
spn state working
spn devices list --json
spn integrations install copilot
spn doctorThese commands are proposals, not installation instructions. Reserve --quiet,
--json, --no-color and --non-interactive. Redirected stdout must not start
an interactive dashboard. Hook commands never prompt and keep stdout empty.
The persistent shell now keeps preferred output, brightness, animation profile/LED model and export shell across launches. Settings → Preferences edits these values; Configuration documents the equivalent scripting commands. Preview mode remains a session choice. Home displays these defaults, a bounded host-status query and the last action in the current session, inside the same menu panel.
Esc returns from menus, including the searchable / action palette. Esc or Ctrl+C
cancels shell forms and retains text for retry; Ctrl+U clears the current input.
Ctrl+C during an executing command requests cancellation, and Ctrl+C on Home exits.
Only successful settings saves change the preferred output. Errors leave the shell
open. This does not complete the proposed live dashboard, persistent activity history,
all specialized editor controls or real Windows Terminal acceptance.
SidePulse.NET is an unofficial companion for SidePulse. Documentation describes the planned product unless explicitly marked implemented.