Skip to content

Terminal Experience

github-actions[bot] edited this page Oct 26, 2026 · 3 revisions

Terminal experience

Status: design proposal. There are no application screenshots yet.

Visual direction

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.

Dashboard

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.

Main areas

  • 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.

Proposed commands

spn
spn link
spn state working
spn devices list --json
spn integrations install copilot
spn doctor

These 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.

Implemented preferences and Home

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.

Clone this wiki locally