Superterminal 0.1.18

Native Windows client (per-user install, no admin) with a GPU-rendered terminal grid, talking to a WSL daemon over loopback TCP. macOS build for Apple silicon attached as a DMG.

What's new in 0.1.18

• Jev directly from TypeSafe. The palette's plain-words ranking can now call TypeSafe's own endpoint, not only OpenCode Zen's passthrough. It answers about twice as fast: a median of 290 ms against 654 ms on the palette's test queries, with the same picks on every one. Get a key at console.typesafe.ai.
• Pick a provider, or let it pick. AI Settings… has a provider row that cycles Auto → TypeSafe → OpenCode Zen. Auto uses TypeSafe when it finds a TypeSafe key and falls back to Zen, so an existing Zen or OpenCode setup keeps working with no change. A pasted key starting with apikey_ is recognised as TypeSafe's.
• One stored key per provider. Switching providers never loses the other key. The choice you make in the dialog is remembered on that machine.
• Clearer failures. Test connection names the provider, the model that answered and the latency. A key or model the provider rejects turns ranking off for the session and says why, instead of retrying on every keystroke. Rate limits back off for as long as the provider asks.

Configuration

Everything is optional; the dialog covers it. For config.toml:

[ai]
provider = "auto"   # or "typesafe" / "zen"
# api_key = "apikey_…"   # or set TYPESAFE_API_KEY

TypeSafe is pinned to jev-1.13.0, the model the palette was tuned on. Set model = "jev-latest" to follow their alias instead.

What leaves your machine

Unchanged from 0.1.17: nothing without a key. With one, a palette query sends the query plus command titles, tab titles, working directories and session names to the provider you chose. Screen text goes out only if you turn on [ai] screen_context, masked for secrets first.

Install (Windows)

1. Run Superterminal-0.1.18.msi (per-user, installs to %LOCALAPPDATA%\Superterminal, adds a Start Menu shortcut). It upgrades 0.1.17 in place.
2. Once: setx SUPERTERMINAL_SERVER /home/<you>/superterminal/target/release/superterminald
3. Launch Superterminal from the Start Menu.

Install (macOS)

Open superterminal-0.1.18-arm64.dmg and drag Superterminal to Applications. The app is ad-hoc signed, not notarized, so the first launch needs right-click → Open.

Notes

• Screen search needs a daemon from 0.1.17 or later; an older daemon quietly finds nothing.
• The background WSL session keeps the WSL2 VM in memory after you close the app, on purpose, so the session survives.
• Unsigned Windows build, so SmartScreen prompts on first launch.

Superterminal 0.1.17

Native Windows client (per-user install, no admin) with a GPU-rendered terminal grid, talking to a WSL daemon over loopback TCP.

What's new in 0.1.17

• One palette, on Cmd+K / Ctrl+K. Commands, tabs and sessions now live in a single list. Type part of a tab's title, its directory or its session name to jump straight to it. Cmd+Shift+P / Ctrl+Shift+P still opens it; Switch Session moved to Cmd+Shift+S / Ctrl+Shift+S.
• Find a tab by what is on its screen. Type baby, E0308 or mismatched types and the tab showing it comes up, with the matching line beside it. This needs no key and makes no network call: the daemon answers with the visible rows of every tab in the session, including tabs that are not being rendered, and the match runs locally.
• Plain-words queries, if you want them. With an OpenCode Zen key, "kill this tab", "split below" or "the frontend one" are ranked by Jev, TypeSafe's decision model. It never blocks: local matching answers every keystroke, and Enter always acts on the row under the cursor. Without a key the palette behaves exactly as it does above.
• AI Settings… in the palette stores that key, tests the connection and shows where the key came from. The key is kept in secrets.json beside your window state and is never shown beyond its last four characters.
• From 0.1.16: Cmd+Enter as a newline chord, and the Kitty keyboard protocol.

A change you may need to undo

Ctrl+K now opens the palette on Windows and Linux, which takes it away from readline's kill-to-end-of-line. One line in config.toml gives it back:

[keybindings]
"palette.commands" = "ctrl+shift+p"

What leaves your machine

Nothing, unless you add a key. With one, a palette query sends the query itself plus command titles, tab titles, working directories and session names.

Screen text is not sent unless you turn on [ai] screen_context, which is off by default. When it is on, only a short excerpt of each tab goes out, and bearer tokens, sk-/ghp_/xoxb--style keys, AWS ids, private-key blocks and password=/token= assignments are masked first.

Install (Windows)

1. Run Superterminal-0.1.17.msi (per-user, installs to %LOCALAPPDATA%\Superterminal, adds a Start Menu shortcut).
2. Once: setx SUPERTERMINAL_SERVER /home/<you>/superterminal/target/release/superterminald
3. Launch Superterminal from the Start Menu.

Upgrading: the daemon must be restarted to answer the new screen-text request, which re-seeds your shells. Until it is, the palette works as before and screen search quietly finds nothing.

Notes

• The background WSL session keeps the WSL2 VM in memory after you close the app, on purpose, so the session survives. It is released when Windows restarts or sleeps.
• Sleep/hibernate still stops the WSL VM (a WSL limitation); the daemon restarts on the next launch.
• Unsigned build, so SmartScreen prompts on first launch.

v0.1.15

Native Windows client (per-user install, no admin) with a GPU-rendered terminal grid, talking to a WSL daemon over loopback TCP.

What's new in 0.1.15

• About dialog. The command palette (Ctrl+Shift+P) now leads with About Superterminal, which shows the build's version and links to the project at https://github.com/sonnylazuardi/superterminal. Enter or a click opens the link in your default browser; Esc closes.
• superterminal --version reports the real release number. Packaged builds used to print 0.1.0; the version is now compiled into the client.
• From 0.1.14: switching tabs no longer auto-pastes the clipboard, and the session survives with no WSL window open (the client holds the WSL VM up with a hidden background session).
• From 0.1.13: on Windows, Ctrl+C copies the selected text (and interrupts when nothing is selected).

Install (Windows)

1. Run Superterminal-0.1.15.msi (per-user, installs to %LOCALAPPDATA%\Superterminal, adds a Start Menu shortcut).
2. Once: setx SUPERTERMINAL_SERVER /home/<you>/superterminal/target/release/superterminald
3. Launch Superterminal from the Start Menu.

Notes

• The background WSL session keeps the WSL2 VM in memory after you close the app, on purpose, so the session survives. It is released when Windows restarts or sleeps.
• Sleep/hibernate still stops the WSL VM (a WSL limitation); the daemon restarts on the next launch.
• Unsigned build, so SmartScreen prompts on first launch.

v0.1.10

Native Windows client (per-user install, no admin) with a GPU-rendered terminal grid, talking to a WSL daemon over loopback TCP, plus the macOS arm64 app.

What's new in 0.1.10

• The Windows client starts the WSL daemon itself. When nothing answers on the TCP target it boots WSL and runs superterminald inside a hidden wsl.exe, waiting up to 30 s for a cold WSL boot. No more "Failed to connect" after a restart or resume.
• Set the user variable SUPERTERMINAL_SERVER to the daemon's path inside your distro (default: superterminald on WSL's PATH), and SUPERTERMINAL_WSL_DISTRO if it is not the default distro.
• The client re-subscribes after every automatic reconnect (the tab list stayed empty before) and shows "Reconnecting…" while it retries instead of a dead-end error.
• Stable reattach, remembered window placement and tab layout (Client State) from 0.1.9.

Install (Windows)

1. Run Superterminal-0.1.10.msi (per-user, installs to %LOCALAPPDATA%\Superterminal, adds a Start Menu shortcut).
2. Once: setx SUPERTERMINAL_SERVER /home/<you>/superterminal/target/release/superterminald
3. Launch Superterminal from the Start Menu. The daemon comes up on its own.

Install (macOS)

Open superterminal-0.1.0-arm64.dmg and drag the app to Applications (Apple silicon, unsigned).

Notes

• Do not start the daemon with --daemonize from Windows: WSL kills every process of a wsl.exe session when that wsl.exe exits. The optional Startup entry in docs/WINDOWS.md runs it attached with --no-idle-exit.
• Unsigned builds, so SmartScreen / Gatekeeper prompt on first launch.
• Full build/run docs: docs/WINDOWS.md in the source tree.

v0.1.7

Native Windows client (per-user install, no admin) with a GPU-rendered terminal grid, talking to a WSL daemon over loopback TCP.

Install

1. Run Superterminal-0.1.7.msi (per-user, installs to %LOCALAPPDATA%\Superterminal, adds a Start Menu shortcut).
2. In WSL, start the daemon: superterminald --tcp 127.0.0.1:7171
3. Launch Superterminal from the Start Menu.

Contents

• Single-file superterminal.exe (no console window) + native grid module side by side
• Start Menu shortcut with app icon, Apps & features entry
• SUPERTERMINAL_TCP default (127.0.0.1:7171), override it if your daemon listens elsewhere

Notes

• Unsigned build, so SmartScreen will prompt on first install.
• Split panes need a protocol-1.1 daemon (this tree); a 1.0 daemon still works, one pane per tab.
• Full build/run docs: docs/WINDOWS.md in the source tree.