Repository navigation
SUPER DESKTOP 1.2.0
Protocol: 3 (unchanged)
Install: curl -fsSL https://raw.githubusercontent.com/gladimdim/super-desktop/master/install.sh | SUPER_DESKTOP_VERSION=v1.2.0 bash
Changes since v1.1.21.
What users see
- A command-line interface,
super-desktop, for people and agents: list and inspect terminals and harnesses, launch harnesses with a prompt and card position, read terminal output, send input, move, resize, focus, color-tag and close cards, manage notes, layouts, settings, shortcuts, file references and pairing, and attach to a terminal. Changes are guarded and leave receipts. See CLI.md for the full reference. - A local MCP server lets agents read the desktop's terminals and, when you allow it in Settings, coordinate them: launch harnesses, send input and wait for a launch to finish.
- Arrange fills the current workspace: cards favor readable landscape terminals, and an incomplete last row stretches across the full width instead of leaving gaps.
- After a reboot, each card resumes its own Claude Code or Codex conversation, not just the latest one in that folder.
- The Files panel finds more files in terminal output, including paths that Claude Code or Codex wrapped onto the next line in a narrow card, and plays audio files.
- Showing the overlay is smoother: cards reuse the still images taken when it was hidden.
- The install command and Settings → Updates follow releases instead of the development branch.
SUPER_DESKTOP_VERSION=latestinstalls the newest release, andSUPER_DESKTOP_VERSION=masterfollows the branch. - Arch packages, released source archives that include Rust dependency license notices, and a GPL-3.0-only license declaration.
- An early macOS development build of the desktop.
- A redesigned website with live demos and real clips, and link previews when the website is shared on social sites.
Bridge changes
- Adds optional phone-sized terminals: a compatible phone can request a terminal grid that fits its screen through the opt-in
viewport=1stream negotiation, renewed every 10 seconds and expiring within 30 seconds when the connection is lost. - Older phones keep the existing stream behavior unchanged. Newer phones on an older PC see no viewport capability and keep font fitting and panning.
- Protocol stays at 3. Existing routes, fields and frames remain available.
Fixes
- Terminal bounds are correct after a display change.
- Rebuilds work when CARGO_TARGET_DIR is inherited from the environment.
- The still image shown while the overlay slides is no longer blank for a busy terminal.
- A daemon closing its socket no longer loses the reply of a lifecycle command.
Validation
- The full Rust suite passed: 668 main-binary tests plus the library, client and integration tests. Seven opt-in tests were ignored, and large-screen GTK checks skipped their assertions as usual.
- Real-phone compatibility testing was not performed for this release.