Changelog

Added

• Linux support (beta) — UnionTerminal now runs on Linux via a single x86_64 AppImage, first-class on Omarchy. Download, `chmod +x`, run. Huge thanks to @rtbhhi for building the Linux support.

Fixed

• Auto-update is working again on Windows. The 1.0.67 and 1.0.68 Windows installers shipped without a config file the updater needs. You'll need to download and run the 1.0.70 installer by hand once; after that, auto-update works normally. macOS was never affected.
• Update checks are now resilient to failure. If the auto-updater fails, the app now independently checks GitHub's latest release and shows an "Update available" banner pointing to the download page.

1.0.69 fixes auto-update on Windows, broken since 1.0.67, and adds a resilient fallback for future update failures. If you're on Windows, read this one.

Fixed

• Auto-update is working again on Windows. The 1.0.67 and 1.0.68 Windows installers shipped without a config file the updater needs, so every update check failed before it reached the network — if you're on Windows, you've been seeing "Couldn't check — try again" since July 28th, with no way to auto-update out of it. That file is back in this build. But because your current copy's updater is the thing that was broken, it can't fetch this fix on its own — you'll need to download and run the 1.0.69 installer by hand, once. After that one manual install, auto-update goes back to working normally. macOS was never affected.
• Update checks are now resilient to failure. If the auto-updater ever fails to check for updates again — whether from a config file going missing or a network problem — the app now independently checks GitHub's latest release and shows an "Update available" banner. Click it to visit the download page where you can get the latest version. This fallback is notify-only; it won't download or install in the background. It's there exactly to prevent another incident like 1.0.67/1.0.68, where the primary check breaking meant users had no way to know an update was available.

1.0.68 is a fortification pass — stronger against crashes and multi-monitor weirdness, and about a third smaller to install.

Improved

• Recovers instead of crashing when the GPU acts up. If UnionTerminal hits repeated graphics-driver crashes, it now falls back to software rendering on the next launch automatically — a slower terminal instead of one stuck in a crash loop it can't get out of.
• Steadier across multi-monitor and mixed-DPI setups. Dragging the main window onto a display with a different scale, or having a display's own scale change under a stationary window, no longer leaves it oversized or off a live screen — its bounds are re-fit automatically. Terminal panes also no longer choke if a resize lands on a shell that has already exited, which is exactly the kind of race a fast display change can trigger.
• About a third smaller to install. The packaged app drops from 285 MB to 187 MB — roughly 98 MB less to download and keep on disk — with the core app bundle itself (app.asar) going from 263.1 MB down to 180.8 MB. Packaging now leaves out build tooling and other files the running app never used, and a batch of oversized decorative art was downscaled to the size it's actually shown at. This is about what you download and store, not how the app runs day to day — speed and memory are unchanged.
• Satellites find their way home. If the monitor a Satellite window was on gets disconnected, it now relocates to a display that's still there instead of stranding off-screen — and a minimized Satellite is left alone rather than misread as "stranded" and silently moved.
• A crashed Satellite or dock window recovers instead of hanging around dead. Every window — not just the main one — is now watched for a renderer crash. Previously a dead Satellite renderer left a frameless window you couldn't even close, and a dead dock renderer made every docked session unreachable; both are now detected and closed/recreated automatically instead of sitting there unresponsive.
• Fewer silent failures generally. Errors thrown from a timer, an unawaited background task, or a startup step that used to vanish with no dialog and no log entry are now caught and recorded — including some startup steps that, if they failed, could previously take a batch of unrelated features down with them (shell detection, workspace saving, schedules) without any indication why. Exporting a terminal or saving settings also now surfaces a real error message on failure instead of an opaque "object could not be cloned."
• Reopening from the Dock on macOS works properly. Closing UnionTerminal's last window and reopening it from the Dock no longer leaves clipboard history, file-preview watching, and Claude Code Mode's connection stopped in the background.
• Custom keyboard shortcuts are handled more carefully. A shortcut that doesn't quite parse no longer throws past registration, and matching is no longer case-sensitive, so a shortcut like "command+alt+u" isn't rejected just for capitalization.
• Claude Code Mode leaves fewer stray processes. A chained statusline setup could leave the wrapped process running in the background even after the timeout that was supposed to kill it — now the whole process tree is killed, not just the wrapping shell.
• Lighter running in the background. Looking up your current git branch and detecting available shells are both briefly cached now instead of re-running on every check, clipboard updates go only to the window that needs them instead of every open window, and the session sidebar's reorder animation and the autosave check both do less repeat work on routine updates.

Improved

• Claude Code Mode now offers itself. It shipped quietly in 1.0.66 and most people never found it. Now, if UnionTerminal detects Claude Code on your machine, it offers to turn the feature on: new installs see it as a row during first-run setup, and if you're updating and already have Claude Code, you'll see a one-time card instead. Say no and it won't ask again. The required "not affiliated with Anthropic" line under the offer is also fully legible now in every theme — it was too faint to read comfortably before.
• Windows trust, taken further. Building on 1.0.66's installer signing: the app executable and the terminal engine's bundled Windows binaries are now signed individually before they're packaged, not just the installer wrapper around them. Updates also no longer install themselves in the background — quitting UnionTerminal any way other than clicking "Restart to update" used to let a downloaded update install anyway; now that click is the only path that installs anything. And a freshly launched copy no longer checks for updates within the first few seconds of startup — a pattern security software watches for — the first check now waits 90 seconds instead of 3.

Fixed

• Claude Code Mode no longer leaves processes behind. The status reporter that connects Claude Code to UnionTerminal could hang and pile up in the background — on heavily used machines, hundreds of them, eating memory. It now always finishes its work and exits, and the fix applies itself automatically the first time you launch this version.
• Claude Code Mode is honest when it isn't actually connected. If it was already running in another copy of UnionTerminal, a second copy used to show the toggle as "on" while its connection to Claude Code was actually dead, with no explanation. Now you get a live warning, and the Settings toggle itself says so.
• The "it's on" confirmation doesn't disappear before you see it. Turning on Claude Code Mode from the one-time offer card could show almost no confirmation — it closed before you could read it. It's now a toast that sticks around.
• A status report that can't be matched to a terminal no longer vanishes silently. You'll get a one-time notice instead of nothing at all.
• Off really means off. With Claude Code Mode switched off, a leftover internal session identifier could still leak into a newly opened terminal's environment. It no longer does.

Added

• Claude Code Mode (Beta). Turn it on and every terminal running Claude Code gets a live instrument panel — no more guessing when a session is about to run out of room.
• Fuel Gauge. A ring on each session card fills green → amber → red as the conversation's context fills up, with the exact percentage and current model always visible. Hover for a plain-language read, click for the full explainer. A one-time tip introduces it the first time you see it.
• Switch Track. Change models right from the sidebar or a session's Satellite — pick from the full model list (Fable 5, Best, Opus, Sonnet, Haiku, 1M-context variants, Opus Plan) or type an exact model id. Switches wait for a natural pause, so they never interrupt a response or type into your prompt.
• Fully local, on your terms. The gauge reads local Claude Code data only — no telemetry, nothing leaves your machine. Turning it on shows you exactly what setting it changes before you confirm, and it's off by default and one click to turn back off.

Improved

• Trusted Windows installers. Windows installers and updates are now code-signed, so SmartScreen recognizes UnionTerminal as a verified publisher — fewer (often zero) "unknown publisher" warnings when you install or update.

Fixed

• Links in previews open safely now. Clicking a link inside a previewed document could blank the entire window until you relaunched. Links now open in your default browser instead.

Fixed

• Emoji no longer corrupt your terminal text. An outdated character-width table made emoji and other wide symbols get measured wrong, so everything after one would shift left — swallowing spaces, mashing words together, garbling whole lines. This is also what looked like "pasted text getting doubled or mangled": the paste was always fine, the rendering wasn't. Both are fixed now.
• Focus view works again. Clicking "Focus view" on a file preview was closing the preview and then doing nothing — no reading overlay, no error, just silence. It opens properly now.
• Find works inside Focus view. Searching within Focus view always came back with zero matches, no matter what you searched for.
• Dragging a beacon chip no longer widens the dock. On Windows displays running at 125% or 150% scaling, picking up a chip made the whole beacon dock visibly stretch.

Improved

• Focus view is instant now. Opening it no longer re-renders the document a second time, so long documents don't freeze and the transition doesn't stutter — and your scroll position carries over both ways, so you land on the line you were reading instead of jumping to the top.
• Beacons are quicker to use. One click expands a chip instead of requiring a double-click, parking a terminal to a beacon is noticeably faster, chips no longer flicker or vanish when you take a screenshot, a chip dragged near a screen edge can't get stranded off-screen anymore, and letting go of a drag no longer accidentally expands it.
• Typing no longer yanks you to the bottom. Scroll up to read earlier output and start typing — your place is kept instead of snapping down to the prompt. The jump-to-bottom button is still there when you want it.
• Satellites open on the right screen. They now appear on whichever monitor UnionTerminal is on, instead of always defaulting to your primary display.
• Clearer focus when panes are split. An accent ring marks the pane receiving your keystrokes, inactive panes show a hollow cursor, and entering or leaving Focus view transitions more smoothly. Right-click now works anywhere on a terminal, not just its tab.
• Steadier tabs, lighter background load. Tab labels no longer twitch when you switch between them, the app does less background work with many sessions open, and clipboard images stop being needlessly reprocessed behind the scenes.

Fixed

• Copying from the terminal actually works now. Selecting text and copying (Ctrl+C or Ctrl+Shift+C) now reliably lands on your system clipboard — with a quiet "N characters copied" confirmation — instead of silently failing. Copying *inside* a terminal program (Claude Code, tmux, vim, and the like) now reaches your clipboard too.
• No more gap beside the file-preview panel. Opening the preview while the clipboard panel is closed no longer leaves an empty strip between it and your terminals, and dragging the preview's edge now resizes the panel itself instead of just widening the gap.
• Enter works after using Find. After opening Find (Ctrl+F) in a file preview, clicking back into a terminal and pressing Enter now sends your line, instead of being swallowed by the find bar.

Improved

• Silky panel and sidebar resizing. Opening or closing the clipboard, file-preview, and sidebar panels now cross-fades the terminal text as it re-wraps, instead of a hard, jarring snap — the panels glide and the content dissolves smoothly into its new width.
• Lighter, calmer clipboard. The clipboard panel no longer does needless background rendering many times a second, so the whole app stays smoother and more responsive during everyday use.

Improved

• Much lighter with many terminals. Running lots of terminals — or several agents at full output at once — now does about 95% less background work, so typing stays instant and the app stays light even with a dozen-plus busy sessions. Under a heavy load that used to max out UnionTerminal's engine, it now sits around 90% idle — a huge margin before anything can bog down. Heavy output feels smooth, with far fewer little stutters.
• Leaner startup. UnionTerminal now starts with a ~16% smaller core, and the file-preview view loads the first time you open a preview instead of at launch — so the app is quicker to get going.

Improved

• Beacon dock, more capable. Beacon chips now show their expand and dock controls at rest — no need to hover — and you can drag the dock to reposition it anywhere on screen. Collapsing a Satellite to a beacon is seamless now: no flash, and the window and its chip never appear at the same time.
• Tidier link previews. The hover card for file paths and links stays fully on screen near any window edge, with cleaner, more consistent styling.

Fixed

• Hidden terminals stay hidden. A terminal you hide with the eye toggle now stays hidden after a restart or update, instead of quietly reopening as a tab.
• Beacons survive screenshots. Taking a screenshot no longer makes your beacon chips vanish or slip behind other windows.
• Wrapped file paths are clickable. A long path that wraps onto the next line in the terminal now opens on click — no need to widen the terminal first.
• Double-click to expand a beacon. Double-clicking a beacon chip reliably reopens its Satellite.
• No stray edge shadow. Fixed a faint shadow line that could linger at the window's edge after collapsing the clipboard or file-preview panel.

Improved

• Beacon mode, refined. Collapsed Satellites now gather as a tidy row of floating chips — with consistent size, spacing, and shape on any screen size and on both Windows and macOS, and they stay crisp and legible in every theme. Chips colour-code to their session (personal *or* group colour), and you can double-click a chip to expand it.

Fixed

• Renames stay in sync. Renaming a session now updates its beacon chip and Satellite everywhere, not just its tab.
• Rename from a card starts on the card. Choosing Rename from a sidebar card's menu now edits the card inline, instead of jumping focus to the tab header.
• No duplicate Satellite. Summoning a collapsed session from its sidebar card now expands it in place, instead of leaving both a floating chip and a full window on screen.
• Consistent session colours. A session's accent colour now shows correctly on its beacon chip and Satellite, whether it comes from the session or its group.

Added

• Beacon mode for Satellites. Collapse any Satellite to a small floating chip that stays pinned and out of the way — its live status light and session colour visible at a glance. Click the chip to expand it back, or dock it to UnionTerminal. Beacons hold their place through sleep/wake, and follow you to your laptop screen when you unplug an external monitor.
• Paste a screenshot into the terminal. Copy an image — or take a screen-snip — and paste: UnionTerminal drops the image's file path into your prompt so tools like Claude Code can read it instantly. Dragging an image in works the same way.
• Unified notifications. Toasts, the what's-new banner, onboarding, and surveys now share one tidy corner system that stays out of your way instead of stacking up or covering your work.

Improved

• Stays smooth under heavy output. Running several agents in one tab — or any high-volume output — no longer lags or freezes. Output renders in batches with GPU acceleration, so the UI stays responsive.
• Calmer, smarter Satellites. Reach toward a faded Satellite and it brightens instantly; clicking its sidebar card reliably summons it to the front; pinned Satellites stay on top even after a screen-snip.
• Polished throughout. Smooth entrance animations for panels, cards, menus, and dropdowns, and one consistent tooltip style across the whole app.
• More reliable session restore. Your tabs, working directories, and split layout come back faithfully after a restart or update.
• Cleaner pastes. Large pastes are paced so the first characters are never dropped.
• Lighter long sessions. Long, compacted sessions use noticeably less memory.

Fixed

• Windows stability hardening. A foundation-up pass against rare crashes and data loss: PTY callbacks, clipboard reads, and the close-time workspace save are now guarded, with opt-in crash visibility so problems surface instead of vanishing silently.
• No multi-monitor GPU crashes. Dragging windows between monitors with different scaling no longer risks a GPU or renderer crash.
• No heavy-output freeze. Fixed the spinning-cursor hang and the rare crash during very high-volume output.
• Cleaner tabs. The active terminal tab now connects seamlessly to its pane.

Privacy

• Privacy & data controls in Settings. A single Anonymous usage switch — on by default — counts installs and which features get used, and never your commands, file paths, or terminal content. An optional Help shape the product toggle lets you help guide what we build next; it's anonymous, and you can reset or delete your data anytime. Honors `DO_NOT_TRACK`.

macOS

• Beacon chrome hides the native traffic lights while collapsed and restores them on expand, so the chip stays clean.

Added

• feat: Layout presets — one toolbar control for Single / Columns / Rows / Grid, switchable with Ctrl+Shift+1–4 (⌃⇧1–4 on Mac). Presets auto-balance so N terminals share space evenly.
• feat: Split controls — split the active panel from a tab's hover icons, its right-click menu, or Ctrl+Alt+Arrow (↑ above · ↓ below · ← left · → right). On Mac use Control+Option, not Command.
• feat: Balance panes — right-click a tab → Balance panes to restore even sash sizes after manual dragging (presets already balance themselves).
• feat: Custom layout persistence — manual splits and sash positions are saved in your workspace snapshot and restored after quit or update.
• feat: Terminal mark mode — Ctrl+Shift+M toggles keyboard selection mode (Windows Terminal style). Use arrow keys to move, Shift+Arrow / Shift+Home / Shift+End to select, Ctrl+A to select all scrollback, Enter to copy and exit, Esc to cancel. Shift+nav also extends an existing mouse selection.

Improved

• improvement: Right-hand rails push terminals — clipboard and file preview dock beside the terminal workspace instead of covering it; terminals reflow when a rail opens or resizes (minimum column width preserved on narrow windows).
• improvement: Simpler layout toolbar — removed the separate Split dropdown and Balance button from the toolbar; splitting now lives on tabs and the keyboard, and balancing in the right-click menu, so the toolbar stays uncluttered.
• improvement: Columns and Rows presets now tile one panel per column/row (not just two-way splits) before balancing sizes.
• improvement: Freeform layout mode — manual splits switch to freeform so preset buttons only rebuild when you explicitly pick Single/Columns/Rows/Grid.

Fixed

• fix: Layout shortcuts — Ctrl+Shift+3 (Rows) no longer collides with Ctrl+Shift+D (Dock Satellite), and the digit chords now work regardless of keyboard layout.

Added

• feat: Satellite Mode — launch any terminal session into its own floating window with full CLI fidelity, nothing simplified. A compact instrument chrome shows live cwd, git branch, and status; a soft accent glow rises from the base so a focused Satellite is easy to spot. Pin to keep it on top, and it ghosts (gently fades) when you're working elsewhere. Click its sidebar card to summon it, or dock it back to UnionTerminal when you're done. Run up to five Satellites at once across every monitor.
• feat: Satellite hotkeys — Ctrl+Shift+D (⌘⇧D on Mac) docks the focused Satellite; Ctrl+Alt+S summons or hides every Satellite at once.

macOS

• improvement: Satellite windows use native traffic lights and respect ⌘-based shortcuts on macOS.

Added

• feat: Shell integration — live terminal cwd for PowerShell, bash, and zsh. Toggle in Settings → Terminal.

Improved

• improvement: Path links — click previews when the file exists (silent when not). Shift+click shows help. Ctrl+click (⌘ on Mac) opens; Ctrl+Shift+click reveals in Explorer or Finder.
• improvement: Project-relative paths — `package.json`, `./src/file.ts`, and similar resolve against live shell cwd, Starting folder, and recent preview folders.
• improvement: Selection fallback — highlight a path and Shift+click (Ctrl, ⌘, Alt, or middle-click) when auto-detect misses.
• improvement: URL links — click opens in your browser; Alt+click copies the URL.
• improvement: Terminal paste — Ctrl+V and ⌘+V refocus the terminal before pasting.

macOS

• improvement: zsh & bash cwd — shell integration reports live folder over OSC 7 in macOS terminals.

Added

• feat: Pre-update changelog — when an update is available, the footer expands to show what's new (release notes, category icons, and decorative art) before you restart. Hover or click the update card for the full list; Restart to update when you're ready.

Improved

• improvement: Update check — the version pill opens a simple utility panel (current version + Check for updates); if an update is found, you're taken to the changelog card instead of a duplicate modal.
• improvement: Update promo art — banner illustrations are theme-aware, full-bleed, and easier to read across Galaxy, Void, Dayliner, and Supernova.

Fixed

• fix: Update UI — smoother pill-to-card transition; Later stays dismissed; accessibility fixes for focus while the promo animates.

Fixed

• fix: Usage sharing — if sharing is on in Settings, anonymous counts should stick better after updates.

Improved

• improvement: Sidebar — minor footer attribution tweak.

Added

• feat: Scroll to bottom — when you scroll up in a long session, a ↓ button appears to jump back to live output.
• feat: Settings panel — larger, searchable layout with clear sections (Appearance, Shortcuts, Terminal, Privacy, Editor connections).
• feat: Clear scrollback sync — optional setting to mirror shell screen clears (and slash commands like `/clear`) into Union’s scrollback. Off by default.
• feat: Terminal scrollbar — choose Thin or Comfortable width in Settings.

Improved

• improvement: File paths — paths split across wrapped terminal rows work with Shift+click and multiline selection.
• improvement: Feedback — version and resolved theme in reports come from the app, not the form.

Fixed

• fix: Clear scrollback — cursor stays at the bottom after clearing; replay buffer stays in sync.
• fix: Feedback metadata — emails show correct version and theme (e.g. system → dark).

Added

• feat: Hide terminals — minimize a terminal out of the grid without closing the shell. Restore from the sidebar card, tab bar, or group controls; sessions keep running in the background.
• feat: Optional usage sharing — Help improve Union Terminal in Settings sends anonymous usage counts to help prioritize what we build. Off by default. Never includes commands, file paths, clipboard, or terminal output. Turn off anytime in Settings.
• feat: Feedback categories — tag feedback as Bug, Idea, Workflow, or Other so we can respond faster.

Improved

• improvement: All hidden empty state — when every terminal is minimized, the workspace shows how to restore them and reminds you shells are still running.
• improvement: Hide / restore controls — clearer icons on tab headers and sidebar cards (hide vs. single-view focus).

Fixed

• fix: Grid layout after restore — un-hiding a terminal in grid mode puts panels back in the right arrangement instead of collapsing to tabs.

Improved

• improvement: Preview /ask — your highlighted text stays visible while you ask about a selection.
• improvement: Feedback — cleaner send form; optional reply email; screenshots coming soon.

macOS

• improvement: Signed & notarized — macOS downloads are Developer ID signed and notarized; install by dragging to Applications.

Added

• feat: New terminal startup — in Settings, set an optional starting folder and commands (one per line) that run when you open a new terminal with + or Ctrl+Shift+T.

Improved

• improvement: Shell picker — the toolbar and doc-preview shell menus render above terminals (portal overlay), fixing the dropdown hidden behind panels.

Added

• feat: In-app feedback — send bug reports and ideas from the Feedback link in the sidebar footer (optional reply email).

Improved

• improvement: Sidebar cards — single-click surfaces hidden terminals and focuses the cursor; double-click or context menu Rename works on cards and tab headers.
• improvement: Sidebar toggle — expand animation now matches the smooth collapse slide.

Added

• feat: Find in document — Ctrl+F (Mac: ⌘F) searches within the docked preview and focus view; Enter / Shift+Enter step matches; Esc closes the find bar first.

Improved

• improvement: Doc panel resize — drag the preview rail across the full window width (over the sidebar); only the open clipboard rail limits the maximum width.

Fixed

• fix: Doc panel resize — preview width can again expand to the terminal/sidebar edge (regression from v1.0.45 layout wrapper).

Improved

• improvement: Empty workspace art — larger, responsive launch illustration when no terminals are open; updated artwork.

Added

• feat: Empty workspace art — theme-aware hero illustration when no terminals are open.

Improved

• improvement: Website — marketing site and docs now live at www.unionterminal.app (union.iamtherobot.io redirects).
• improvement: App links — sidebar footer and onboarding guide open the new domain directly.

Added

• feat: Recent files — clock menu in the preview header lists files you have opened; shuffle with Ctrl+Shift+← / → in the docked panel and focus view. Recents persist across sessions.
• feat: Ask about selection on HTML — highlight text in rendered HTML preview, press / when the hint appears, and send a cited excerpt to the source terminal — same flow as markdown.

Improved

• improvement: Preview rail shortcuts — Ctrl+Shift+F toggles file preview only; Ctrl+Shift+K toggles clipboard only; Ctrl+Shift+H still hides or restores both rails together.
• improvement: Recents shuffle — Ctrl+Shift+← / → walks the full recents list in dropdown order (loops); keyboard shuffle no longer reorders the list.
• improvement: Smoother file switching — cycling recents crossfades content in place; focus view stays open with a stable panel size.
• improvement: Toolbar — window controls stay visible when the window is narrow (Windows); traffic-light gutter on macOS.
• improvement: Preview header — open file, reveal in folder, and spawn a new terminal in the file folder when the source session is gone.

Improved

• improvement: Shift+click file preview — terminal paths like `package.json`, `src/config.json`, and `tsconfig.json` (not only absolute or `./` paths) open in DocView when you Shift+click.
• improvement: JSON preview — `.json`, `.jsonc`, and `.json5` files are pretty-printed in the preview; use the header toggle to view raw source.
• improvement: Preview size limit — text previews now allow files up to 2 MB (was 1 MB).

Added

• feat: First-run welcome — non-blocking quick tips card (layouts, file preview, capture & share); dismiss with Got it or Esc. Reopen anytime from sidebar Tips.
• feat: Docs hub — user guide and keyboard shortcuts on union.iamtherobot.io; Docs link in the app sidebar and Read the guide on the homepage.

Improved

• improvement: Sidebar footer — Settings opens from its own pill; version line is for updates only. Theme-aware Robot logo. Contribute label (was Support).
• improvement: Path preview errors — clearer toasts with a highlight-and-Shift+click fallback when auto-detection fails.
• improvement: Pre-update preview — available updates show a brief changelog highlight before install.

Added

• feat: HTML document preview — `.html` and `.htm` files render as static pages in the docked preview and focus view (no scripts). Toggle raw source like markdown.

Improved

• improvement: Open in browser — preview header button on HTML files opens the full page in your default browser when you need scripts or interactivity.
• improvement: Reading colours — preview header button cycles theme, light, and dark reading modes; the same setting carries between docked and focus view. Set the default for new file previews in Settings.

Added

• feat: Global show/focus shortcut — press Ctrl+Alt+U (default) from anywhere to bring Union Terminal forward and focus the active terminal. Change or disable it in Settings → bottom-left.

Improved

• improvement: Terminal focus on open — opening Union Terminal or spawning a new terminal now places the cursor in the terminal automatically, ready to type.
• improvement: Settings panel — opens at a readable width over the main area (not clipped inside the sidebar); drag the corner to resize.
• improvement: Tab split — Split this tab in the tab menu (or drag a tab to a panel edge) moves the current terminal into a new tile, like a browser tab — use Duplicate or + for a fresh session.
• improvement: Terminal resize — scrollback reflows correctly after narrowing or widening a panel; switching tabs or resizing the sidebar refits every terminal reliably.

Fixed

• fix: Single view sidebar — typing at the end of a long line no longer pushes the session sidebar off-screen.

Added

• feat: Ask about selection — highlight any passage in document preview or focus view, then press `/` when the / ask pill appears. Add optional instructions and send a cited excerpt to the terminal that opened the file — Insert in terminal to paste and review, or Send in terminal to submit straight into Claude Code or your CLI.

Improved

• improvement: Ask about selection — instant inline confirmation when your excerpt lands in the terminal, and the / ask hint stays ready so you can fire off another question right away — even while the success checkmark is still showing.

Added

• feat: Live preview refresh — document preview stays in sync with the file on disk. Edits from Claude Code or another app show up automatically, with a manual reload in the header, a quick Up to speed pulse, and last-modified time in the footer.

Added

• feat: Selection path actions — highlight a path in the terminal to get the same preview tooltip and Shift/Ctrl/Alt click actions as linked paths (fallback for wrapped lines and edge cases).

Fixed

• fix: Supernova/Dayliner readability — light truecolor text from tools like Claude Code stays readable on warm/light terminal backgrounds.

Added

• feat: Mermaid in document preview — fenced ` ```mermaid ` blocks render as diagrams in markdown preview (docked panel and focus view), with light/dark theme support and offline lazy loading.

Improved

• improvement: Path links in Claude output — trims sentence-ending periods and prose glued after file extensions (e.g. `file.md.` or `file.md.It's in your home directory`).

Fixed

• fix: Shift+click on directories — reveals the folder in Explorer/Finder instead of opening a broken preview.
• fix: Shift+click on missing files — shows an error toast instead of failing silently.
• fix: Ctrl+Shift+H after Shift+click preview — collapse/restore keeps clipboard rail state when reopening preview from collapsed rails.

Added

• feat: Document preview rail — Shift+click a path link in the terminal to preview file contents in a docked side panel; Esc closes, Ctrl+Shift+H hides/show the rail without unloading the file.
• feat: Focus view — Ctrl+Shift+O toggles a centered reading overlay from the docked preview (works while the terminal stays focused). Click the backdrop or press Esc to return to the docked panel.
• feat: Right rails toggle — Ctrl+Shift+H (toolbar Panels button) hides or restores the document preview rail, clipboard rail, or both together.
• feat: Preview zoom — Ctrl+scroll (Cmd+scroll on Mac) zooms text in docked preview and focus view.
• feat: Focus view colour default — choose theme colours or light mode as the default when entering focus view (Settings → bottom-left).

Improved

• improvement: Resizable preview panel — drag the preview edge to resize; clipboard rail stacks correctly beside it.
• improvement: Keyboard shortcuts from terminal — Ctrl+Shift+H and Ctrl+Shift+O work while typing in the terminal (xterm focus), matching layout and new-terminal shortcuts.

Fixed

• fix: Preview-first Ctrl+Shift+H — hiding the preview rail now works reliably after opening a file via Shift+click with focus still in the terminal.

Improved

• improvement: Path link tips — clearer shortcut list, stays until dismissed, and appears bottom-right with other notifications.
• improvement: Single copy shortcut — Alt+click (Option+click on Mac) copies a shell-ready path; quotes are added automatically when the path contains spaces.

Fixed

• fix: Integration toast positioning — tips no longer appear in the bottom-left corner due to a CSS unit typo.

Added

• feat: Clickable terminal paths — file and folder paths in output are detected automatically. Hover for a preview (name, type, size, line:column). Click to open, Alt+click to copy, Ctrl+click to reveal in Explorer or Finder.

Added

• feat: Dayliner and Supernova themes — system light mode uses the static Dayliner theme; Supernova keeps the animated sunburst. Existing light-theme users are migrated to Supernova.

Fixed

• fix: Clipboard send/drag focus — text and image paths now insert through xterm so the cursor lands after the content; Enter submits to the shell instead of re-firing the clipboard panel.
• fix: Text no longer auto-submits — trailing newlines from copied text are stripped before insert so chat inputs (Claude Code, etc.) wait for Enter.
• fix: TUI chat compatibility — clipboard text uses bracketed paste so in-app chat composers receive the full string reliably.
• fix: Escape only closes the clipboard panel when focus is inside it; scheduled messages still focus the target terminal after send.

Added

• feat: Clipboard panel overhaul — scrollable history for text and images; click or drag to send to the active terminal. Images write to a temp PNG path for tools like Claude Code.
• feat: Image annotation — draw arrows, circles, and labels on clipboard screenshots; send the marked PNG path to your terminal.
• feat: Editor integration — connect Union Terminal as the external terminal for VS Code, Cursor, VS Code Insiders, and VSCodium from Settings. Includes backups and safe JSONC settings edits.
• feat: Settings panel refresh — collapsible sections, default theme picker, and improved GalaxyTrain contrast.

Fixed

• fix: Clearing all marks before send now sends the original image, not a stale annotated file.
• fix: Lowering clipboard history size trims the UI list in sync with main process eviction.
• fix: Linux editor config paths use XDG (`~/.config/...`) instead of macOS paths.
• fix: Path quoting handles spaces and embedded double quotes on Windows.

Fixed

• fix: "Open Union Terminal here" now actually opens a terminal — Electron injects `--allow-file-access-from-files` between `--cwd` and the folder path in argv (e.g. `--cwd --allow-file-access-from-files C:\path`). The parser now scans past any injected `--flags` to find the real path value.
• fix: Low-contrast text in the Default Terminal settings card is now legible on all themes including GalaxyTrain.

Fixed

• fix: "Open Union Terminal here" now opens at the right folder — Electron injects an internal `--cwd` flag for its sub-process infrastructure which was overwriting the Explorer-supplied folder path. The parser now takes the first valid `--cwd` value and ignores any value that starts with `--` (i.e. another flag, not a path).

Added

• feat: Default terminal integration — Union Terminal can now be set as your default terminal. On Windows, enables an "Open Union Terminal here" entry in the Explorer right-click menu for any folder. On both platforms, registers the `union-terminal://` URI scheme so apps like VS Code and GitHub Desktop can open sessions directly. Toggle on/off anytime in the version popover (bottom-left).
• feat: Open at folder — right-clicking a folder in Explorer (Windows) and choosing "Open Union Terminal here" opens a new tab already `cd`-ed to that directory.

Added

• feat: macOS support — Union Terminal is now available as a universal `.dmg` for both Intel (`x64`) and Apple Silicon (`arm64`) Macs. Download from the website or releases page. Note: this is an unsigned build — on first launch right-click the app and choose Open, then confirm in System Settings → Privacy & Security.

Fixed

• fix: Critical — v1.0.24 crashed immediately on launch with a blank window due to a call to `event.api.onDidDispose` (which does not exist on Dockview's top-level API). Replaced with a proper ref-based cleanup pattern. All v1.0.24 users will be auto-updated to this build.
• fix: Dev and production builds now use separate userData directories so running both simultaneously no longer causes a single-instance lock collision (which on production manifests as a blank window).

Improved

• improvement: Tab and sidebar card colors now stay perfectly in sync — a single `useEffectiveColor` hook is the sole source of truth, so both views always agree on the resolved color (group color › personal color)
• improvement: Terminal xterm palette now updates immediately when the OS switches between light and dark while Union Terminal is running in "system" theme mode
• improvement: Drag-and-drop panel reorganization — tabs reorder smoothly like browser tabs in focused view; in tiled view the swap drop zone on the terminal body now works as expected alongside the tab header zone
• improvement: Clicking a tab or sidebar card automatically focuses the terminal input so you can type without an extra click

Fixed

• fix: Terminals spawned after changing the default shell now correctly use the updated shell setting (stale closure was reading the original value)
• fix: Context menu no longer renders partially off-screen on narrow displays
• fix: "dragend" event listener is now properly cleaned up when the Dockview layout is disposed, preventing listener accumulation
• fix: Terminal output replay no longer silently swallows IPC errors on reconnect

Added

• feat: Right-click or click "…" on any tab or sidebar card to open a context menu with Rename, Duplicate, Export text, Clear scrollback, Schedule message, and terminal color picker
• feat: Schedule a message — set a date/time (and optional recurrence) to automatically send a command to any terminal; missed schedules shown on next launch with Send Now / Discard
• feat: Tab and card colors — pick an accent color for any terminal; shown as a left-border stripe on sidebar cards and a colored highlight on the tab header
• feat: "Send to Terminal" button on every clipboard item — text uses bracketed paste (safe for multi-line), images send the file path to the focused terminal
• feat: Terminal groups — create named folders in the sidebar to organise your terminals; drag any terminal into a group or use the group's + button to spawn one directly inside it
• feat: Group colors — optionally assign an accent color to a group; all terminals in the group inherit it as their sidebar stripe and tab highlight
• feat: Group focus — click a group name to temporarily show only that group's terminals in the viewport; other tabs stay open in the background
• feat: Sidebar drag-to-resize — drag the right edge of the sidebar to any width you prefer; the size is remembered across restarts
• feat: Clipboard images now use a responsive aspect-ratio thumbnail and a persistent action footer (Send, Preview, Drag) — no more hover-only buttons
• feat: View crash log — new button in the version popover opens the crash log in your text editor for easy bug reporting
• feat: Crash recovery — if the renderer crashes, Union Terminal now shows a dialog with Restart / Quit options instead of silently closing

Improved

• improvement: Groups collapse and expand with a smooth animation; the entire header row is clickable to toggle, and a chevron rotates to indicate state
• improvement: Groups are displayed with a colored left-border stripe (or neutral stripe when uncolored) so you can distinguish them at a glance even when collapsed
• improvement: A pulsing amber dot appears on a group header whenever any terminal inside is awaiting your input — the same signal used on individual terminal cards
• improvement: Toolbar "New Terminal" button shows "+ in [Group]" when a group is focused, so it's always clear where the terminal will land
• improvement: Export text now uses the terminal's name as the filename instead of a truncated ID
• improvement: Workspace is now auto-saved within ~1.5 s of any change, so groups, colors, and session layout survive unexpected exits and dev reloads — not just graceful close
• improvement: Scheduled messages that target a closed terminal are now silently cleaned up rather than surfacing an error toast

Fixed

• fix: Speech-to-text tools (Wispr Flow) now type into the terminal again — paste handling no longer intercepts synthetic paste events
• fix: Sidebar terminal cards no longer oscillate focus when multiple Claude Code sessions are active — sort order is driven solely by last click, not PTY output activity
• fix: Tab header color stripe now correctly reflects the terminal's group color when a group color is set
• fix: Terminal colors are no longer lost on restart — the accent color is now correctly persisted and restored through the workspace save/restore cycle
• fix: Recurring scheduled messages no longer accumulate ever-growing IDs across repeated fires
• fix: Sidebar version footer sits at the bottom of the sidebar as intended

Fixed

• fix: Paste now sends text to the terminal exactly once — eliminates double-paste when using Ctrl+V or speech-to-text tools like Wispr Flow that issue a paste event

Improved

• feat: Sidebar can now be hidden and restored — click the panel toggle button (far left of the toolbar) or press Ctrl+Shift+B to collapse or expand it with a smooth animation

Fixed

• fix: Ctrl+V paste now works reliably — uses Electron's synchronous clipboard read, eliminating silent failures when document focus shifts
• fix: Terminal content no longer cut off after window or panel resize — added a trailing fit pass that runs once layout transitions settle
• fix: Sidebar terminal cards no longer jitter or reorder while typing — activity timestamps are throttled to once per 2 seconds per session
• fix: Awaiting-input detection now catches Claude Code's "1. Yes / 2. Yes, don't ask again / 3. No" menus by reading the visible terminal buffer instead of single PTY chunks
• fix: Light theme (Supernova) ANSI white text is now legible — white and bright-white slots render dark on the white background

Improved

• improvement: Clipboard panel now resizes responsively with the window — clamped between 220px and 280px (40vw) so it never dominates a narrow window

Improved

• improvement: Terminal panels no longer have a visible border — they appear as borderless floating cards in all layout modes, with a subtle shadow for depth
• feat: Shell picker now includes a "Browse for shell executable…" option — click to choose any executable on disk and it will be remembered as a custom shell option

Fixed

• fix: Thin grey line visible between terminal panels is removed — the dockview sash element now renders fully transparent when idle

Improved

• improvement: Terminal panels are now borderless floating cards with a subtle shadow — consistent with the sidebar card style, applies across all views (single, split, grid, stacked)
• fix: GalaxyTrain theme terminal background now shows the correct deep indigo colour instead of near-black — caused by the v1.0.17 viewport transparency fix revealing the html body background

Fixed

• fix: Dark charcoal bars at the bottom of terminal panels in grid and stacked views — the xterm viewport background is now transparent so the panel's own background shows through where no rows are rendered
• fix: Toast notifications (update ready, what's new) now show the Union Terminal logo instead of a generic sparkle icon

Improved

• improvement: Terminal panels now have visible rounded corners on all sides — a 4px gutter around the panel area shows the surface background behind each panel, making the floating-card look consistent in single, split, grid, and stacked views
• improvement: "What's new" is now shown on the first launch after an update installs, not in the pre-install toast — this means the changelog is always read from the newly installed app and the content is always accurate
• fix: Update toast no longer shows generic "general fixes and improvements" text — it now shows a clean "Restart to update" message and defers the changelog to the post-install launch

Improved

• improvement: Tab tops now have rounded corners — just like browser tabs
• improvement: Terminal panels have rounded corners throughout; in split and grid views the panels float with subtle gutters between them (the galaxy backdrop peeks through on GalaxyTrain theme)
• improvement: Borders between the sidebar and terminal area, and between panels in split/grid/stacked modes, have been removed for a cleaner, more modern look
• improvement: Keyboard shortcut hints removed from the sidebar footer — they are already shown as tooltips on the layout buttons in the toolbar
• improvement: Layout button tooltips are cleaner and now read "Columns — Ctrl+Shift+R" style
• fix: Ctrl+Shift+1 now correctly switches to Single view (the shortcut was shown in tooltips but never wired up)

Added

• feat: Update toast now shows every version you skipped — if you jump from 1.0.10 to 1.0.14, you see all the changes from each release in between, grouped by version
• feat: Release notes are read from the bundled changelog rather than the raw update metadata, so what you see is always accurate and complete

Fixed

• fix: Taskbar badge dot was blue/teal instead of amber — corrected pixel byte order and reduced dot size to match system notification badges
• fix: All terminals incorrectly showed a pulsing amber dot at idle — shell prompt characters ($, >, #, %) were removed from waiting detection so only genuine program prompts (yes/no confirmations, Claude Code selections) trigger the signal
• fix: Amber waiting dot persisted forever on idle terminals — resolved as a consequence of the detection fix above
• fix: Taskbar/dock badge now persists until the user actually responds to a prompt, rather than silently disappearing after 45 seconds

Added

• feat: Terminals waiting for your input now show a pulsing amber dot on the tab and in the sidebar — so you can see at a glance which session is waiting without switching to it
• feat: When one or more terminals are awaiting input, a small amber badge appears on the taskbar icon (Windows) or Dock icon (macOS)
• feat: Prompt detection is smarter — covers yes/no confirmations, Claude Code and other TUI-style CLIs that use ◆ / ❯ selection markers, and readline-style question prompts

Fixed

• fix: Terminal sessions now actually restore when you close and reopen the app — the workspace save was silently failing because it ran after the renderer was already destroyed. Save now happens while the window is still alive
• fix: App no longer requires "Run as administrator" — installer is now locked to per-user install so Windows never marks it as needing elevation

Fixed

• fix: Terminal sessions now actually restore when you close and reopen the app — the workspace save was silently failing because it ran after the renderer was already destroyed. Save now happens while the window is still alive
• fix: App no longer requires "Run as administrator" — installer is now locked to per-user install so Windows never marks it as needing elevation

Added

• feat: Terminal sessions are automatically restored after an update or restart — your terminals reopen in the same shells with the same names, and your scrollback history is visible above a subtle "session restored" marker
• feat: Groups (folder organisation in the sidebar) are also restored, with their names and colors preserved
• feat: Layout mode (columns / rows / grid) is restored alongside sessions

Added

• feat: Copy and paste keyboard shortcuts in the terminal — Ctrl+V (or Ctrl+Shift+V) pastes from your clipboard with bracketed-paste support, so multi-line text from Cursor / docs / chats lands intact
• feat: Ctrl+C copies the current selection (and clears it); with no selection it still sends SIGINT like every other terminal
• feat: Ctrl+Shift+C always copies the current selection regardless of focus

Fixed

• fix: Dragging an image from the clipboard panel into the terminal now inserts the absolute file path — tools like Claude Code can now actually open the image. Previously only the filename made it through, due to an Electron 32 platform change

Fixed

• fix: In-app updates no longer fail silently — the installer wizard now shows properly so you can see the license screen and choose your install path
• fix: Robot logo in the sidebar footer now displays in full color (red robot head) instead of a hard-to-see white silhouette
• fix: Privacy and Terms links in the sidebar footer are now legible on every theme

Fixed

• fix: Installer build failed because of an electron-builder config rename — license property is now correctly named (no user-visible behavior change; the license screen still appears during install)

Fixed

• fix: CI typecheck failure caused by execFile overload resolution — switched installer launch to spawn (functionally identical, cleaner types)

Added

• feat: Privacy Policy and Terms of Use published at union.iamtherobot.io/privacy and /terms
• feat: Installer now shows a license agreement screen — you must click "I Agree" to install
• feat: Privacy and Terms links in the sidebar footer below the version label
• feat: "Built by Robot" logo in the sidebar footer links to iamtherobot.io

Fixed

• fix: Update toast no longer shows raw markdown headings (### Fixed) as changelog entries — section headers are now filtered out before display

Fixed

• fix: Installer launch fails on Windows when username contains a space — app now launches the downloaded installer directly via execFile (no shell interpolation) so usernames like "Jeremy Ashbury" are handled correctly

Added

• feat: Shell badges on every tab and sidebar row — instantly see whether you're in PowerShell 7, Windows PowerShell, Command Prompt, Git Bash, WSL, or another shell at a glance
• feat: Version footer at the bottom of the sidebar — click "Union Terminal · v1.0.3" to open an update-check panel with inline status and one-click install

Added

• feat: Pick from any installed shell (PowerShell 7, Command Prompt, Git Bash, WSL) — split-button next to "New Terminal" makes the choice clear and per-terminal
• feat: Polished update toast with categorized changes (New / Improved / Fixed) and proper iconography

Fixed

• fix: Hardened startup so the app can't silently fail to launch
• fix: Clipboard panel now scrolls properly instead of stacking items off-screen
• fix: Window stays visible after switching monitors or undocking a laptop
• fix: Re-launching the app while it's running now focuses the existing window
• fix: Multi-size taskbar icon — Windows now picks the correct sharpness for every context
• fix: Dropdown menus and toasts are now fully opaque on the GalaxyTrain theme (previously hard to read over the star backdrop)

Improved

• perf: Crash log written to %APPDATA%\union-terminal\crash.log for diagnostics
• perf: Release notes pipeline — clean changelog-driven notes flow from the project repo into every update toast

Added

• feat: Initial release with multi-tab terminals, grid/split layouts, clipboard panel, terminal grouping, fuzzy search, and three themes (GalaxyTrain, VoidExpress, Supernova)

Union Terminal 1.0.65 — general fixes and improvements.

No release notes for this version.

No release notes for this version.

No release notes for this version.