This release adds per-repository visual identity across the entire app.
New
- Each repository can now have a custom icon and color. Pick an SF Symbol or upload any image, and choose from 10 system colors in Repo Settings. The identity appears in the sidebar row, shelf spine header and background, and canvas card title bar.
- Custom Command tabs now display the command's configured icon for the lifetime of the tab. Run Script tabs keep the play icon throughout the run instead of briefly flashing before switching to the detected command icon.
- Repo Settings is now accessible from the shelf spine context menu.
Fixed
- The "Choose Image" file picker in Repo Settings now opens inside the repository's working directory instead of the last-used Finder location.
- Hovering the spine's New Tab, Split Vertically, and Split Horizontally buttons now shows the correct per-button tooltip with the associated shortcut key. Previously, the book-level tooltip masked all three buttons.
- User-uploaded repository icon images now display with rounded corners.
Fixed
- Fixed a bug where terminal windows could open in the wrong Light or Dark appearance at startup.
This release brings mouse-driven Canvas navigation and improves reliability for long-running sessions.
New
- Canvas zoom with Cmd+scroll wheel: hold Cmd and scroll to zoom in or out, anchored on the cursor position. Works with both mouse wheels and trackpads.
- Canvas pan with middle-click drag: press and drag the middle mouse button to pan the Canvas. Terminals never see the click, and middle-click works normally outside Canvas mode.
Fixed
- The
prowl CLI no longer loses its connection to the app after a few days. macOS periodically cleans /tmp, which was deleting the socket file and causing APP_NOT_RUNNING errors even with the app running. The socket is now stored in ~/Library/Application Support/com.onevcat.prowl/. A one-time app relaunch is required after upgrading to bind the new path.
- Prowl now applies a runtime Ghostty theme fallback when you have a single theme configured and it mismatches the current macOS appearance (light/dark). No changes are written to your Ghostty config file.
- Canvas auto-fit now reserves space for toolbars and gives cards a bit more room, so cards no longer end up hidden under UI chrome.
- The Canvas navigation help popover no longer truncates its content, and the middle-click hint is hidden for Magic Mouse users who cannot middle-click.
Tab icons now update automatically based on the running command, making it easy to tell at a glance what each terminal tab is doing.
New
- Auto-detecting tab icons: Prowl now detects the running command from the terminal title and displays a matching icon in the tab bar and Shelf spine. Brand icons are available for coding agents (Claude, Codex, Gemini, Copilot, Amp, and more), editors, package managers, runtimes, VCS tools, containers, and databases — over 55 command mappings in total. The icon stays visible after a short-lived command finishes as a "what is this tab for" hint, and is never overridden if you have manually locked an icon via the Icon Picker.
- Context-aware Shelf close action: The Shelf spine context menu now shows "Close Worktree" or "Close Folder" depending on the book type, replacing the old "Remove Book" entry. Closing removes the book from the Shelf without touching the underlying directory or worktree. This also works on the main worktree, which previously showed the option but did nothing.
Fixed
- Staggered background refresh schedules across worktrees so periodic git and pull-request checks no longer fire simultaneously, reducing CPU spikes when many repos are open.
- Shelf empty-state wording now consistently refers to worktrees, matching the rest of the UI.
This release introduces Shelf, a new way to view and navigate your worktrees, along with a significant performance improvement that eliminates a source of main-thread hangs.
New
- Shelf view: a new presentation mode that stacks your worktrees as books with vertical spines. Press
Cmd+Shift+Enter or click the Shelf button in the sidebar toolbar to toggle it. Each spine shows the worktree name, branch, and tab slots; click any spine to open that book.
- Navigation shortcuts in Shelf: navigate between books with
Cmd+Ctrl+← / Cmd+Ctrl+→, navigate between tabs with Cmd+Ctrl+↑ / Cmd+Ctrl+↓, or jump directly to a specific book with Ctrl+Option+1–9. All bindings are rebindable in Settings → Shortcuts.
- Command-key tab hints: hold
Cmd while in Shelf to swap each tab slot's icon for its 1–9 digit, making keyboard switching more discoverable.
- Default View setting: choose whether Prowl launches into the standard view or Shelf in Settings → General.
Improved
- Eliminated a main-thread hang (App Hang) triggered by rapid file-change or pull-request-refresh bursts. A repeated
standardizedFileURL comparison in the sidebar render loop was accumulating enough work to stall the UI for 3+ seconds; the result is now computed once per worktree at construction time, so the sidebar stays responsive under heavy activity.
Fixed
- Shelf now correctly restores focus to the open book's terminal after SwiftUI reparenting, and properly tracks which worktrees the user has actually opened rather than showing all known worktrees.
- Toggling into Shelf from Canvas now honors the card that was focused in Canvas as the open book, rather than falling back to a default.
This release focuses on canvas usability improvements and broader code host support.
New
- Canvas cards now show close and expand buttons in the title bar when you hover over them, letting you act on any card without focusing it first.
- When a focused canvas card is closed (via button, Cmd+W, or any other method), focus automatically moves to the nearest surviving card so the highlighted state stays consistent.
- The "Open on Code Host" action now works beyond GitHub and beyond open pull requests. Worktrees with a PR still open the PR; others fall back to the repository homepage. GitLab-style remotes are supported.
- Code host actions in the toolbar and command palette are now labeled with the detected host name (e.g., "Open on GitHub" vs. "Open on GitLab").
- "Change Tab Icon..." and "Open Repository on Code Host" are now hidden from the command palette's empty-query list to reduce noise. Type to search for either action.
Fixed
- Restored two-finger scroll for TUI programs (pagers, editors, etc.) inside canvas mode. A previous optimization incorrectly forwarded scroll events to the canvas when Ghostty reported no scrollback buffer, breaking apps like
nvim, less, and htop.
- Fixed a crash (EXC_BREAKPOINT abort) that could occur during ANR detection due to Sentry invoking a Swift concurrency callback off the main thread.
This release focuses on tab customization and a less-interrupting update experience.
New
- Tab icons: Right-click any terminal tab and choose "Change Tab Icon..." to pick from a curated SF Symbol preset grid or enter any SF Symbol name directly. You can also invoke this from the Command Palette (Cmd+P, search "icon"). Custom icons survive app restarts when Restore Terminal Layout on Launch is enabled.
- Rename from context menu: "Change Tab Title..." is now available directly in the tab right-click menu, in addition to the existing keyboard shortcut flow.
- Quiet update notifications: Available updates no longer interrupt your session with a dialog. A badge appears in the toolbar instead; click it (or use "Check for Updates...") when you are ready to install.
- Anonymous quality telemetry: To help improve Prowl, this release adds lightweight anonymous crash reporting and memory usage telemetry. No personal data is collected. If you prefer not to participate, you can opt out in Settings.
Fixed
- The "Download and install automatically" setting has been removed; it conflicted with the new silent update detection flow and was not functional in this build.
This release focuses on Custom Command power-ups and two Canvas reliability fixes.
New
- Custom Commands can now open a New Split, running your command in a new pane alongside the current terminal. Choose split direction (left, right, up, down) per command in Settings.
- Close on success toggle for New Tab and New Split targets: when enabled, the tab or split is automatically dismissed after the command exits with code 0, leaving it open on failure so you can inspect the output.
- The toolbar status badge now animates in and out smoothly, and a brief toast appears when a Custom Command completes successfully.
Fixed
- Creating split panes with Cmd+D or Cmd+Shift+D while in Canvas mode no longer freezes rendering. All panes now display and accept input correctly.
- Two-finger pan on the Canvas is no longer interrupted when the cursor drifts over a focused terminal card mid-gesture. Scrolling on a card with no scrollback content now pans the canvas instead of being silently consumed.
Fixed
- Fixed a race condition when entering Canvas view that could leave the terminal surface blank.
New
- Fetch before worktree creation: Prowl can now run
git fetch against the relevant remote before creating a new worktree. The option is on by default and can be toggled in Settings > Worktree. Fetch errors are logged but do not block worktree creation.
- Merged worktree action: The "auto-archive on merge" toggle has been replaced with a three-option picker — Do Nothing, Archive, or Delete — controlling what happens to a worktree when its pull request is merged. Find it in Settings > Worktree. Existing configurations migrate automatically.
- Global defaults for copy flags and merge strategy: The "copy ignored files", "copy untracked files", and "pull request merge strategy" settings can now be configured once as global defaults in Settings, with optional per-repository overrides. Repository-level pickers show the current global value when no override is set.
Fixed
- Terminals could appear blank after exiting Canvas view due to the surface losing its host attachment. Prowl now detects and recovers from this state automatically.
This release focuses on worktree management improvements and quality-of-life fixes.
New
- Auto-delete archived worktrees: A new setting in Worktree Settings lets you configure a period (1, 3, 7, 14, or 30 days) after which archived worktrees are deleted automatically.
- Reveal in Sidebar: Press Shift+Cmd+L to scroll the sidebar to the currently selected worktree, expanding its repository section if collapsed.
- Archived worktrees discoverability: Archive confirmation dialogs now tell you where to find archived worktrees (Menu Bar > Worktrees, or Control+Cmd+A). A "View Archived Worktrees" entry is also available in the command palette.
Fixed
- Restored terminal surfaces no longer spin the CPU and GPU when they are not displayed, keeping resource usage low for non-visible tabs after session restore.
Tab layout and Worktrees menu discoverability are the main themes of this release.
New
- All worktrees and plain folders now appear in the Worktrees menu, regardless of count. Previously only the first 9 were shown. Items beyond the 9th no longer have keyboard shortcuts but remain reachable via the menu or Help > Search.
- Manually renamed tab titles and icons are now saved in the terminal layout snapshot and restored when the layout is reloaded.
- Added Homepage and Release Notes links to the Help menu and sidebar footer.
Fixed
- Plain folders were missing from the Worktrees menu entirely; they now appear in the same order as the sidebar.
Fixed
- When using a transparent background (
background-opacity < 1) in dark mode on macOS 26, the titlebar and window border now correctly appear dark-tinted instead of showing an unwanted light glass effect.
- The sidebar footer now displays a proper frosted glass effect when the background is transparent, rather than a plain semi-transparent fill that let the wallpaper bleed through without blur.
- When creating a worktree, the base branch picker now includes local branches alongside their upstream counterparts. Previously, tracked local branches were omitted, making the picker appear to only support remote refs.
This release brings a redesigned sidebar with a modern, cleaner, and more compact layout, along with reliability fixes across the terminal surface and CLI.
New
- Redesigned Sidebar — the sidebar has been completely re-laid out for a modern, cleaner, and more compact look, giving you more room to focus on your work.
- Reveal in Finder is now available in the worktree context menu, opening the worktree directory directly in Finder.
- The run script indicator (green play icon) now shows a red stop button on hover; clicking it stops the running script.
- The tab count badge on repository headers now shows a tooltip with the active tab count when hovered.
- CLI tool install and uninstall results now show a toolbar toast on the main window for all entry points (Command Palette, menu bar), so you always get feedback regardless of whether Settings is open.
prowl key now correctly emits ANSI control characters for Ctrl-[, Ctrl-\, Ctrl-], Ctrl-^, and Ctrl-_ combos, and uppercase letters preserve their shift meaning.
Fixed
- Hovering a worktree row no longer causes a vertical layout jump when pin and archive buttons appear.
- Archive, Delete, pin, and archive buttons are now hidden for the main worktree, where those actions do not apply.
- Terminals could appear blank after exiting Canvas view due to occlusion state being applied before the surface was reattached to the view hierarchy; this is now deferred correctly.
Prowl gains a command-line tool for scripted terminal control.
New
prowl CLI: Control Prowl from the command line with open, focus, send, read, list, and key commands. Run prowl --help to get started.- Install the CLI from within the app: Go to Settings > Advanced, the Prowl menu, or the Command Palette (Cmd+P) and choose "Install Command Line Tool" to add
prowl to /usr/local/bin.
- Auto-launch on
prowl open: If Prowl is not running when you invoke prowl open <path>, it launches automatically and then opens the requested path.
- Auto-target resolution: All selector commands (
focus, send, read, key) now accept a positional <target> argument or -t/--target flag. Pass any pane UUID, tab UUID, or worktree name and Prowl resolves the type automatically.
prowl send --capture: Snapshots the screen buffer before and after command execution and returns the diff as captured output, useful for scripted workflows that need to inspect command results.- Layout restore warning: When a saved terminal layout snapshot cannot be restored, Prowl now shows a warning in the toolbar instead of silently resetting.
Fixed
- Clicking anywhere on the Canvas row in the sidebar (including padding) now correctly selects Canvas. Previously only the icon and label text were responsive.
- Exiting Canvas could leave the terminal blank until you switched away and back. The surface state is now refreshed immediately on Canvas exit.
Fully customizable keyboard shortcuts and persistent terminal layout across app launches.
New
- Fully customizable keyboard shortcuts: A dedicated Shortcuts page in Settings gives you complete control over every key binding in Prowl. Remap app actions, terminal tab and pane navigation, split management, and the command palette to any key combination you prefer. The editor records shortcuts directly from your keyboard, detects conflicts with existing bindings inline, and lets you replace or cancel on the spot. Whether you are a Vim user remapping splits or just want
Cmd+T to do something different, every shortcut is now yours to define.
- Terminal layout restore: Prowl now remembers your full terminal layout — tabs, splits, and their arrangement — and restores it exactly when you relaunch. Enable "Restore Layout on Launch" in Settings > Advanced, and your workspace is back in seconds, no matter how complex the setup. Use "Clear saved terminal layout" to reset to the default empty state whenever you want a fresh start.
- Custom commands revamp: The repository custom commands editor is now a fully inline-editable table with an SF Symbol icon picker, shortcut recording, and no cap on the number of commands. Commands beyond the first three appear in a toolbar overflow menu.
- Script environment variables: Scripts run by Prowl now receive
PROWL_WORKTREE_PATH and PROWL_ROOT_PATH environment variables (renamed from the old SUPACODE_ prefix).
- Window menu additions: Tab and pane selection shortcuts are now accessible from the Window menu.
Fixed
- Font size no longer resets when switching between worktrees or when Ghostty reloads its config due to custom command changes.
Cmd+0 (reset font size) now affects the current pane only; new tabs inherit the reset size. The old tab-0 and worktree-0 shortcuts (Cmd+0 / Ctrl+0) have been removed to free up these key combinations.- Terminal layout restore now works correctly for plain folders and correctly suppresses re-saving after clicking "Clear saved terminal layout."
- Pane focus is correctly restored after toggling zoom on a split pane.
- Scripts running in fish shell no longer hang due to an
exit $? incompatibility.
Persistent terminal font size and freed-up keybindings.
New
- Terminal font size now persists across sessions. Prowl saves your preferred size and restores it when you relaunch. Font size controls are available in the View menu.
- Cmd+0 has been freed from its previous font-size binding, making it available for custom Ghostty keybindings.
Fixed
- Plain folder repositories now show the correct open tab count in the sidebar header.
Sidebar tab count badges and Homebrew distribution.
New
- The sidebar now shows a small tab count badge next to each repository name, reflecting the total number of open terminal tabs across all worktrees for that repo. The badge appears automatically when tabs are open and disappears when none remain.
- Prowl is now available via Homebrew:
brew install --cask onevcat/tap/prowl. Updates are also delivered through the tap automatically.
Canvas multi-select broadcast input — select multiple terminal cards and type once to send the same input to all of them.
New
- Canvas multi-select: Cmd+Click to select multiple cards, Cmd+Opt+A to select all. Selected cards show a visual distinction between primary (accent ring) and followers (subtle tint).
- Broadcast input: typing in the primary card mirrors committed text and special keys (Enter, Backspace, arrows, Tab, Escape, Ctrl+key) to all selected follower cards.
- IME-safe broadcast: followers receive only committed text (e.g. 你好), not intermediate phonetic input (e.g. nihao). Works correctly with Chinese, Japanese, and other input methods.
- Cmd+V paste and right-click Paste are broadcast to all selected cards.
- Cmd+Backspace (delete line) and Cmd+Arrow (line navigation) are broadcast to followers.
- Escape clears broadcast selection. Click a follower to promote it to primary without clearing selection.
Fixed
- Terminal scrollback position is now preserved during output, preventing unwanted scroll jumps.
- Cmd+W now correctly closes the focused surface in Canvas mode.
Plain folder support and several UX and stability improvements.
New
- Plain folders can now be added alongside Git repositories. They open directly into terminal tabs with their own toolbar, settings, and command palette entries. Git-only actions are hidden when a plain folder is selected. Folders are automatically upgraded to Git repositories when a
.git directory is detected, and conservatively downgraded when it is removed.
- Hotkey actions for archive and delete worktree are now scoped to the sidebar, preventing accidental triggers from the terminal. Close Window (⌘W) now works when no terminal is focused, and Show Window (⌘0) brings the main window to front.
- App size reduced by approximately 7 MB thanks to an optimized YiTong web bundle.
- Added diagnostic logging for scroll jump events to help investigate an intermittent snap-to-bottom issue during scrollback reading.
Fixed
- Exiting Canvas could leave terminal surfaces blank. Occlusion state is now correctly restored whenever a surface is reattached, regardless of how the transition happened.
- The Settings toolbar no longer shows an unnecessary separator on macOS 26.
Canvas double-click navigation and smoother card animations.
New
- Double-click a card's title bar in Canvas to switch directly to that tab's normal view. First click focuses the card with immediate visual feedback, second click switches the view.
- Canvas Arrange and Organize now animate smoothly when repositioning cards.
Fixed
- Blank terminal surface when exiting Canvas via the toggle shortcut.
Command finished notifications and Canvas notification highlights.
New
- Command finished notifications now alert you when a long-running terminal command completes. Configure the duration threshold in Settings.
- In Canvas, unseen notifications now highlight the entire title bar of the affected tab card, tracked per-tab for better granularity.
- Notifications are automatically marked as read when you type into the focused terminal, and command finished notifications are suppressed if you've recently interacted with that terminal.
- Terminal key repeat now works immediately — the macOS press-and-hold accent menu is disabled in terminal surfaces.
- Updated the embedded terminal engine to Ghostty v1.3.1.
- VSCodium is now recognized as a supported editor.
Fixed
- Worktree selection is now cleared when entering Canvas mode, preventing stale focus state.
Ghostty keybindings and actions that previously had no effect now work in Prowl.
New
- You can now rename a tab or terminal surface title from the command palette or a bound key. "Change Tab Title" locks the title until you clear it; "Change Terminal Title" sets the surface title and resumes auto-updates when cleared.
- "Open Config" now opens your Ghostty configuration file in the default text editor.
- Fullscreen (
toggle_fullscreen), maximize (toggle_maximize), and background opacity (toggle_background_opacity) Ghostty actions now work as expected. Opacity toggling requires background-opacity < 1 in your Ghostty config and has no effect in fullscreen.
- The
quit action now routes through the standard macOS termination flow, so any confirm-before-quit prompt still triggers. close_window closes the window containing the active terminal.
Fixed
- The command palette no longer shows duplicate or inapplicable entries (removed redundant "Check for Updates", single-window actions like "New Window", Ghostty debug tools, and iOS-only actions).
Faster and more reliable startup with snapshot-based repository restore.
New
- Repositories now appear immediately on launch by restoring from a local snapshot cache, rather than waiting for the full live refresh to complete. The cache is stored at
~/.prowl/repository-snapshot.json and is always followed by a background refresh to stay up to date.
- Worktree discovery now runs in parallel across all repositories, and the bundled
wt tool is invoked directly instead of through a login shell, reducing startup latency.
Fixed
- Prowl no longer deletes
~/.supacode on first launch when co-installed with Supacode. Migration now copies data to ~/.prowl instead of moving it.
Canvas improvements: better card layout, smarter focus behavior, and a keyboard shortcut to toggle the view.
New
- Press
⌥⌘↩ to toggle Canvas view. The command has also moved to the View menu.
- Canvas now auto-arranges cards on first entry using a masonry-style packing algorithm, which produces a more compact, better-scaled layout.
- When entering Canvas, focus automatically returns to the card you were last working on. When exiting, focus restores to the exact worktree and tab you had active inside Canvas.
- Added notification settings for focus events, allowing you to control when Prowl alerts you about focus changes.
Fixed
- File paths containing Unicode characters (e.g., Chinese filenames) were not shown correctly in diffs and untracked file lists.
Canvas layout and polish improvements.
New
- Added an "Arrange" button to the Canvas toolbar that automatically lays out cards in a waterfall pattern, making it easy to tidy up a crowded canvas.
- Increased the default card size and raised the maximum resize limit, giving more room to work with agent output at a glance.
Fixed
- The Canvas toolbar title no longer appears as a tappable navigation button.
- The Canvas sidebar button label is now properly centered, and no longer bleeds through overlapping content when scrolling.
Initial public release of Prowl, rebranded from Supacode.
New
- Prowl is now the app's name and identity, with an updated app icon to match.
- Sparkle auto-update support is included, so future releases will be delivered automatically.