A customizable terminal workspace —
Retermina beta · v0.6.3 — early access
macOS "damaged" warning? Run xattr -cr /Applications/retermina.app
The newest additions to Retermina — shipped via the built-in updater, so installed copies pick them up automatically.
Your side of the conversation now lines up on the left, next to Claude's replies, instead of floating in the corner on its own. It's still boxed and labeled "You" so it's easy to tell apart — just easier to read top to bottom.
Removed a leftover background bar that used to sit behind the chat composer at the bottom of the window — it just floats over the workspace now, no awkward panel behind it.
Selecting text in the composer now picks a foreground color for contrast against your chosen accent, instead of a fixed color that could go nearly invisible against darker picks. Placeholder and autosuggestion text also got evened out so they read as one consistent weight, not a mismatched tier.
In the installed app, the Agent's send button could stay greyed out — the background agent couldn't find the claude command on its own, so it never finished connecting. Retermina now locates it exactly the way your terminal does, so you can start prompting the instant a workspace opens.
Quit, crash, or auto-update — and your terminals come right back. A dev server or long-running script keeps running the whole time in the background, then reattaches with its scrollback the moment you reopen. Your work doesn't skip a beat.
Reopen after a restart and the Agent view resumes the very same Claude session — your whole conversation restored, ready to keep going. No re-explaining what you were in the middle of.
The Claude Code panel is now a structured Agent view — assistant text, tool calls, and diffs stream in as parsed records instead of raw terminal output, with token-by-token live streaming as Claude writes.
Change the model or permission mode right from the Agent view and it resumes the exact same conversation — no more losing context just to switch to Opus or dial permissions back.
A new contribution heatmap on the Launch Hub tracks lines Claude has edited per day across every project — a Sunday-aligned week grid with Year/Month/Week ranges, streaks, and your most active day and month. Opens scrolled to today, not January.
Installation
Download, drag to Applications, and open — three steps. macOS may quarantine the app on first launch; step 3 clears that.
Download the .dmg
Click Download for Mac above, or grab the latest build from the GitHub releases page.
Drag to Applications
Mount the .dmg and drag Retermina into your /Applications folder.
Clear the macOS quarantine flag
If macOS says "Retermina is damaged and can't be opened", this is Gatekeeper's quarantine — not actual corruption. Open Terminal and run:
Then open Retermina normally.
Start
The same primary actions that greet you when Retermina opens — recreated here with the real card interactions from LaunchActionCard.
Engines
Each engine swaps far more than accent colors — corner radius, border weight, shadows, backdrop blur, fonts, and icon stroke weight all change. Click a chip or use the switcher above.
A structured Agent view streams the Claude CLI as parsed records — assistant text, folded tool cards, diffs — with token-by-token live streaming. Switch model or permission mode mid-session and it resumes the same conversation, while a persistent CLI terminal runs alongside, warmed in the background so it's instant to switch to.
A dedicated panel that auto-launches the claude CLI in its own PTY, with a per-project token-usage strip. Spawned with theme-aware colors so output stays legible on light engines.
A project-wide git diff of your working tree that updates live — so edits the Claude CLI makes in the Terminal show up as you watch, file by file.
Native shells (Zsh, Bash) over a Rust portable-pty, streamed to xterm.js. Split panes horizontally or vertically, each with its own PTY and per-engine palette — plus scrollback search (⌘F) and clickable links that open in your browser.
A Rust + React desktop app — your shell runs locally with no token limits, no subscription, and nothing uploaded. Quick-open (⌘P), a command palette (⌘K), and self-updates are built in.
Project-wide content search (⌘⇧F) backed by a native Rust walk — no ripgrep dependency. Results group by file with line numbers; pick one to open it in the Code panel scrolled straight to the match.
Relaunch and Retermina restores your last workspace, panel layout, and open file — paths and layout only, never file contents or shell history. Head back to the Launch Hub and it forgets, so a deliberate exit lands on the hub.
The long tail
Every chip below ships in the current build. Hover to pause — the full detail on each one lives in the README.
Make it yours
One frosted Settings overlay with seven tabs — Theme, Appearance, Loom, Accessibility, Font, Shortcuts, and Version — writes straight to a persisted store, so every choice survives a restart. Four of them are recreated below: change the accent, font, and workspace scale and watch this page update live, exactly like the app does.
Seven tabs — Theme, Appearance, Loom, Accessibility, Font, Shortcuts, Version. Pick a gradient backdrop, rebind any shortcut, dial in reduced motion or contrast, set the terminal font, and persist it all to settings.json.
Pick any hex accent and the whole app re-tints. Text drawn on the accent flips between near-black and white by WCAG luminance — try the white swatch and watch the label stay readable.
Bundled typefaces or upload your own .ttf/.otf — copied in by Rust and registered at runtime. A pairing control suggests the font that suits the active theme.
Bundle your theme, accent, fonts, terminal + accessibility settings, backdrop, and full panel layout into a portable Loom — apply, export, or import it as JSON (fonts travel with it). Stays on your machine by default; sharing to the community gallery is explicit and opt-in.
Theme + layout presets shared by the community. Install one in the app — Settings ▸ Loom ▸ Import — or download the .json. Sharing your own opens a pull request on GitHub.