# Changelog

<Update label="0.21.0" description="Custom workspace labels, automatic crash and stale-agent recovery, and Windows agent launch fixes" date="June 12, 2026">

### New Features

- Custom workspace labels — assign your own labels to workspaces, shown in the sidebar and managed from settings, with a quick-assign submenu in the workspace context menu

### Improvements

- The app now detects and recovers from renderer and GPU process crashes and hangs instead of leaving a frozen or blank window
- Improved detection and recovery when an agent goes stale, with clearer status in the activity feed

### Bug Fixes

- Fixed launching Claude and Codex agents on Windows
- Fixed pull-from-base and PR prompts using the wrong base branch
- Fixed mobile remote relay links so the connection URLs work correctly
- Fixed documentation links to point to the getpolyscope.com domain

</Update>

<Update label="0.20.0" description="Redesigned first-run experience, fullscreen terminal tabs, server labels in the window title, and a batch of clone, scroll, and theme fixes" date="June 8, 2026">

### New Features

- A brand-new first-run experience: a dithered hero and workspace-source cards put cloning a repo or opening a folder front and center from the very first launch. We think it's a big step up — let us know what you think
- Added fullscreen capability for terminal tabs
- Added an "Open in Finder" command to the command palette (desktop only)
- The selected server is now shown in the window title and across the app
- Absolute path links sent from chat now open in your IDE instead of the in-app browser

### Bug Fixes

- Fixed files being missing when creating a workspace from a repository with no commits
- Fixed a foreign-key error and a stale activity feed when removing a repository
- SSH clones now fail fast with the underlying git output
- Fixed the activity feed jumping to the top when sending a message
- Fixed the theme not switching when re-enabling the automatic light/dark color scheme
- Fixed a Monaco editor crash on themes with non-hex token colors
- Fixed error toasts being hidden behind dialog and sheet overlays
- Improved the Autopilot indicators
- Fixed the context-percentage fallback
- Fixed problems with very long branch names

</Update>

<Update label="0.19.0" description="Changes filter, in-app project settings, and polish for previews and shortcuts" date="April 24, 2026">

### New Features

- Added a filter input to the Changes tab so you can quickly narrow down files in large diffs
- Project settings are now available directly in the app settings as a one-pager view
- Cmd/Ctrl-clicking the preview URL now opens it in your default browser
- Added a `preview.tunnel` option in `polyscope.json` to opt out of the automatic Expose tunnel when the preview URL is already reachable from the client

### Improvements

- Command palette repo search is now more polished
- Keyboard shortcut hints now show Ctrl instead of ⌘ on Windows
- Preview URL now matches the Laravel dev server when using `composer run dev` and not accidentally the Vite server

### Bug Fixes

- Fixed drag & drop of images and files into the prompt input when running in the browser
- Fixed the Search projects input losing focus when hovering over items
- Fixed the sidebar new workspace button
- Fixed an incorrect settings shortcut label

</Update>

<Update label="0.18.0" description="Prompt-first flow, Windows support, global model settings, and terminal mentions" date="April 20, 2026">

### New Features

- New prompt-first launch experience — the app now opens with the prompt input front and center, letting you pick a repo, branch, and workspace and start typing immediately
- Create and open projects inline from the prompt-first dropdown: scaffold a new Laravel application, start an empty project, clone a Git repository, or open a local folder without leaving the input
- Path autocomplete when picking directories for new projects, Laravel apps, and opening folders on the web
- Added `@terminal` mentions so you can include terminal output directly in your agent prompts
- Added global default model and parameter settings — set a default model, Claude effort and fast mode, and Codex reasoning effort once and let repository or workspace settings override when needed

### Improvements

- Renamed "Preview" to "Browser"
- "Open in IDE" now uses each IDE's registered URL scheme (phpstorm://, idea://, vscode:// and friends) so it works reliably with JetBrains Toolbox installs and IDEs outside /Applications
- Closing one of several open windows now actually closes it — hide-to-tray behavior is preserved only for the last remaining window, and Cmd+W targets the focused window
- CI monitoring card is now hidden for repositories without GitHub Actions
- Removed dropdown animations for a snappier feel
- Terminal button in the status bar is now disabled with an explanatory tooltip when no workspace is selected
- Adding a non-git folder now surfaces a clear error toast
- Preview is automatically opened by the agent once `polyscope.json` is written mid-session

### Bug Fixes

- Fixed API requests intermittently failing with a session error after transient network reconnects, system wake, or ping timeouts
- Fixed a renderer crash when an agent sent a malformed `AskUserQuestion`
- Fixed Codex failing when a preview screenshot returned empty image data

</Update>

<Update label="0.17.0" description="Checkpoints, queued message indicators, persistent thinking, and synced preferences" date="April 14, 2026">

### New Features

- Migrated from Tauri to Electron - this allows us to release Windows and Linux support very soon
- Checkpoint support - see exactly what an agent build in each turn, and revert changes
- Added a visual indicator and separator for queued messages so it's clear what's waiting to run
- Thinking messages are now persisted and reappear when reloading a workspace
- App preferences are now synced through server settings, so they follow you across windows and devices
- Binary files in the diff view now show an image preview or a clear binary placeholder instead of garbled content
- Added a right-click context menu to the preview webview with copy and devtools options
- Preview webview can now be "scaled to fit"

### Improvements

- Preview toolbar buttons now have tooltips and split view is the new default
- The workspace cleanup card is now hidden for base repository workspaces
- Mobile workspaces now preload the review channel when opened for a faster first view

### Bug Fixes

- Fixed Codex models failing when sending image attachments without any text
- Fixed plan approval errors after clearing context
- Fixed mobile sidebar delete tapping the wrong target

</Update>

<Update label="0.16.0" description="Workspace archiving, editor tabs, performance improvements, and stability fixes" date="April 6, 2026">

### New Features

- Added experimental workspace archiving — archive workspaces and restore them from the command palette
- Added editor tab — view diffs and file contents in a dedicated tab alongside activity and review
- Added Tab/arrow key navigation in the Cmd+N repo picker to access all workspace creation options (GitHub issue, PR, branch, autopilot, etc.)
- Added "Copy prompt to fix with AI" button to error toasts for quick self-service troubleshooting
- Added JSON schema support for `polyscope.json` with autocompletion, validation, and hover descriptions in the editor
- Added `cloneExclude` config option to skip large directories during CoW clones for faster workspace creation
- Added full-page plan approval view — pending plans now take over the activity feed for better readability

### Improvements

- Scroll position is now preserved when switching between Activity and Review tabs
- Base repository workspaces now sort to the top of the sidebar
- Project names now allow dots when creating new Larvel projects
- Merged workspaces now allow pushing new changes (e.g. from CI auto-fix agents)

### Bug Fixes

- Fixed memory leaks from unbounded activity accumulation causing WebView OOM crashes
- Fixed renderer memory leaks with bounded buffers and cache eviction for long-running sessions
- Fixed white screen after macOS kills the WebContent process — the view now auto-reloads
- Fixed WebKit scroll jumping in the diff view
- Fixed arrow key handling in Cmd+N repo picker producing stray characters
- Fixed crash in diff search on patch-based diffs

</Update>

<Update label="0.15.0" description="Multi-server support, remote relay, Expose tunneling, and split diff view" date="March 30, 2026">

### New Features

- Added multi-server support — connect to multiple Polyscope servers from different windows with a native Servers menu
- Added the ability to use Polyscope in the base repository folder without copying data
- Added a splitscreen view for diffs
- Added VS Code-style quick file opener with Cmd+P
- Added git commit log panel in the right sidebar
- Added plan mode support for Cursor and Codex
- Added `copyGitignored` config option for non-CoW filesystems

### Improvements

- Improved UX of the linked workspace picker
- Theme dropdown now groups themes by dark and light mode
- Image files are now shown visually in the editor instead of displaying binary content
- Cmd+N now opens the repo picker instead of creating a workspace directly
- GitHub issue picker now uses dynamic server-side search
- Plan mode toggle now resets after plan approval
- Git fetch now includes tags automatically
- Mermaid diagram context menu actions (copy, download, open in new tab) now work correctly
- Added `--port` and `--data-dir` CLI args for running multiple server instances on the same machine

### Bug Fixes

- Fixed IME Enter key handling in prompt input
- Fixed media keys being intercepted by notification sounds
- Fixed misleading "Not a git repository" error when git itself fails
- Fixed diff file prefetching crash on large diffs
- Herd commands are only included in `polyscope.json` when the Herd CLI is available

</Update>

<Update label="0.14.0" description="Review mode, Laravel project wizard, and plan model switching" date="March 25, 2026">

### New Features

- Added review mode — run a dedicated review agent on your workspace
- Added Laravel new-project wizard — create new Laravel projects directly from Polyscope
- Added model selector to plan approval so you can switch models between planning and implementation
- Added right-click context menu to the diff panel files
- Added "Open in IDE" option to the file browser context menu
- Added PR refresh controls for workspaces

### Improvements

- Increased git operation timeout for large repositories to prevent workspace creation failures
- Added Sentry EU API endpoint support
- Plan feedback drafts are now preserved across remounts and workspace switches
- Mobile diff view now prefers file name tails over full paths for better readability

### Bug Fixes

- Fixed Cmd+K not working on macOS without clicking the window first

</Update>

<Update label="0.13.0" description="Cursor support, File browser context menu, and Codex MCP servers" date="March 23, 2026">

### New Features

- We now added support for the Cursor CLI - use your Cursor subscription and models with Polyscope
- Added right-click context menu to the file browser with "Open in Finder", "Open in Terminal", and "Add to Chat" actions
- Added support for multiple Sentry projects per repository
- Codex workspaces now load user-configured MCP servers from config files

### Bug Fixes

- Fixed undo/redo not working in the file editor
- Various mobile related bugfixes

</Update>

<Update label="0.12.1" description="Run script improvements and stability fixes" date="March 19, 2026">

### Improvements
- Autostart scripts now no longer steal keyboard focus when opening a new workspace

### Bug Fixes

- Fixed white screen crash when a workspace's default model is no longer available
- Fixed autostart scripts only running the last configured script instead of all of them
- Fixed icons disappearing when closing terminal tabs
- Fixed run script output being duplicated when switching terminal tabs

</Update>

<Update label="0.12.0" description="Clear command, Cursor CLI, fast mode, and preview commands" date="March 18, 2026">

### New Features

- Added `/clear` slash command to start a new conversation while preserving linked workspaces
- Added arrow-up bash history cycling — press ArrowUp in an empty prompt to recall previous bash commands
- Added preview command support — define a `preview.command` in `polyscope.json` to automatically detect and use dynamic preview URLs
- Added configurable auto-save option for the file editor in Settings > Behaviour
- Added "Clear context & Approve" button on plan approval to start a fresh agent with only the approved plan
- Added "Start Autopilot" command to the command palette
- Added Claude fast mode and effort level controls with dynamic model loading
- Added `{{folder}}` placeholder support in setup, archive, and run scripts

### Improvements

- Toolbar dropdowns now use native OS popup menus that render correctly above webviews
- `polyscope.json` is now read from the base repo first, with worktree as fallback — allowing local config testing without pushing
- Terminal sessions are now cleaned up on workspace deletion to prevent memory leaks
- Unsaved changes dialog now guards all file editor close paths
- Added Documentation link to the Help menu

### Bug Fixes

- Fixed paste handling on mobile and touch devices
- Fixed PR links opening twice in the merge button
- Fixed long badge and tag text overflowing in command menu modals
- Fixed PR button stuck in "Creating..." state when the agent is stopped
- Fixed diff parsing crash for users with `diff.noPrefix=true` in git config
- Fixed race condition in plan clear-and-approve causing lost activity indicator
- Fixed merge, PR, and pull-base commands ignoring the user's selected model
- Fixed model selection resetting when the available models list updates
- Restored autocorrect on mobile prompt input

</Update>

<Update label="0.11.0" description="Run scripts, FFF integration, and multi-file discard" date="March 13, 2026">

### New Features

- Added run scripts — define frequently used commands in `polyscope.json` and launch them from the header bar with dedicated terminal tabs
- Added autostart option for run scripts to automatically run commands after workspace setup
- Added per-script and global `runMode` setting to control whether re-launching a script replaces the existing tab or opens a new one
- Added FFF (Fast File Finder) as an experimental opt-in feature for faster, more token-efficient file search
- Added multi-file discard support with shift-click selection in the diff panel

### Improvements

- PR worktrees now use the original branch name instead of a generated identifier
- Dialogs now auto-focus their content on open so keyboard shortcuts work immediately
- Cmd+W now closes the active file or diff view before hiding the window
- Sentry integration now shows API errors on the settings page instead of silently failing

### Bug Fixes

- Fixed terminal toggle shortcut not working before the terminal was first opened
- Fixed stale server processes not being cleaned up on app launch

</Update>

<Update label="0.10.0" description="Diff search, Linear improvements, and preview shortcuts" date="March 12, 2026">

### New Features

- Added find/search within diff view (Cmd+F) with line-level scroll targeting and keyboard navigation
- Added clickable local file links in markdown and rich content views to open files directly in the editor
- Added Linear issue search with filtering and recent issues cache
- Added support for linking multiple Linear teams to repositories
- Added ability to unlink individual Linear teams from a repo
- Linear issue branch names are now included when creating workspaces from issues

### Improvements

- Added Cmd+P shortcut to toggle browser preview on macOS
- Added Cmd+R shortcut to reload the active preview
- Terminal panel now appears in diff view and file edit view
- PR worktrees are now named using the repo name and PR number for clarity

### Bug Fixes

- Fixed Monaco editor scroll position resetting on file save
- Fixed diff view sidebar toggle not working correctly after scrolling

</Update>

<Update label="0.9.1" description="Editor fixes, per-repo settings, and browser preview" date="March 11, 2026">

### Improvements

- Codex fast mode now correctly applies the fast service tier only when enabled
- Added per-repository settings command to the command palette
- Added "Open in Browser" context menu option for workspaces with preview URLs

### Bug Fixes

- Fixed Monaco editor font rendering and search highlight misalignment

</Update>

<Update label="0.9.0" description="Linear integration, file editing, and terminal tabs" date="March 11, 2026">

### New Features

- Added Linear integration — connect via OAuth to browse issues and create workspaces from them
- Added Monaco-based file editing with save support (Cmd+S) and inline edit from diff view
- Added "Use in Autopilot" option for plan approval to convert plans into autopilot stories
- Added compact iTerm-style terminal tabs with Ctrl+Tab cycling and middle-click to close
- Added hunk expansion support to diff view
- Added searchable workspace linking via the command palette
- Added Codex reasoning modes support
- Added /btw side question feature for quick ephemeral queries

### Improvements

- Diff file list now prioritizes filenames over folder paths when truncating
- Agent thoughts are no longer truncated
- Terminal open state is now tracked per-worktree instead of globally
- Diff rendering uses a shared Web Worker pool for faster syntax highlighting
- SVG files are now treated as text instead of images when attaching to Claude
- Renamed "From issue" to "From GitHub issue" for clarity
- Status bar items hide gracefully at narrow widths

### Bug Fixes

- Fixed crash when collapsing selection in empty prompt input
- Fixed terminal initialization error in non-TTY bash sessions
- Fixed interrupt error leaking to UI when switching to autopilot

</Update>

<Update label="0.8.0" description="Sentry integration, configurable shortcuts, and UI improvements" date="March 9, 2026">

### New Features

- Added Sentry integration — connect via OAuth to browse unresolved issues and create workspaces from them
- Added Coding Agents settings section to configure environment variables passed to Claude Code
- Added drag-to-resize for the prompt input editor area
- Added configurable keyboard shortcuts for diff view toggle, attachments, plan mode, dictation, and focus prompt
- Added support for `polyscope.local.json` for local config overrides
- Branch picker now groups branches into local and remote

### Improvements

- Faster worktree deletion — UI updates instantly while cleanup runs in the background
- Slash commands are now loaded per repository instead of using a global cache
- Selected model is now correctly used across merge/PR/push actions, preview element picker, and autopilot story generation
- Added text labels to status bar buttons for better discoverability
- Story drag-and-drop reordering now works reliably

### Bug Fixes

- Fixed preview webview position at non-default zoom levels
- Fixed terminal panel stealing focus from prompt input on content updates
- Fixed diff view and file view overlapping the status bar
- Fixed cloning repos from external volumes
- Fixed browser preview showing Stripe iframe URL instead of actual page URL
- Fixed cancelled CI checks being stuck as in-progress forever
- Fixed crash when changing terminal font before renderer is ready

</Update>

<Update label="0.7.0" description="File references, terminal improvements, and new settings" date="March 5, 2026">

### New Features

- Added @file mention support in autopilot goal dialog and diff/file viewer line comments
- Added terminal font configuration in Settings > Appearance for custom and nerd font support
- Added fullscreen menu item to the Window menu

### Improvements

- Terminal panel now auto-closes when the shell session exits
- Hide "No results found" message while command menus are still loading

### Bug Fixes

- Fixed a crash on macOS versions older than 13.3
- Fixed a crash when processing certain tool inputs

</Update>

<Update label="0.6.0" description="Mobile improvements and diff view enhancements" date="March 5, 2026">

### New Features

- Added file browser to the mobile view
- Added split/unified diff toggle with persistent preference
- File panel search now uses fuzzy scoring for faster results

### Improvements

- Improved diff view with better file header contrast and scroll-to-viewed-file behavior
- Fixed emoji and unicode filename handling across file panel, diff view, and mentions
- Text inputs no longer auto-correct or insert curly quotes
- Improved git branch rename detection

### Mobile Fixes

- Fixed terminal overflow when the keyboard opens
- Fixed layout shift in the Add Repo suggestion list
- Fixed attachment dialog on web/mobile environments

</Update>

<Update label="0.5.1" description="Initial Release" date="March 3, 2026">

### Initial Release

Welcome to Polyscope! The changelog will be updated with detailed release notes starting from the first release after launch. Stay tuned!

</Update>