Superset Release Notes

New Workspace Modal Revamp

The workspace creation modal has been redesigned with improved clarity and new worktree import settings. Branches now load instantly, and the modal preserves your settings between opens.

New workspace modal

• Worktree import settings for cloning directly into a workspace
• Branches appear immediately without a loading delay
• Modal state persists between opens

CodeMirror Editor

We replaced Monaco with CodeMirror for the built-in diff and file editor. CodeMirror is ~97% smaller (150KB vs 5MB), loads significantly faster, and uses far less memory. You'll feel the difference.

CodeMirror editor

Material Icon Theme

File icons in the sidebar and file tree now use the Material Icon Theme, bringing rich per-filetype icons familiar from VS Code. Hidden files are also always visible in the file sidebar.

Material Icon Theme

Cross-Workspace Search

The search bar now supports searching across all open workspaces, not just the active one. Trigger it from the new search bar shortcut to find files and symbols across your entire project.

Cross-workspace search

PR Check Status in Changes Sidebar

CI check results now appear inline in the Changes sidebar alongside your PR. See pass/fail status at a glance without switching to a browser tab.

PR check status in sidebar

Improvements

• Workspace sections drag & drop - Organize workspaces into collapsible sections with full drag-and-drop reordering
• Reorderable changes sidebar sections - Drag the Commits, Files, and other sections in the changes sidebar to your preferred order
• Diff pane selectable - Text in the diff pane is now selectable, with a button to jump to the raw file edit
• Auto-run toggle for agent tasks - A new toggle lets you control whether agent task launches run automatically or wait for confirmation
• Open Preview in workspace hover card - The workspace hover card now includes an Open Preview button for quick access
• Mark as Unread - Terminal and tab context menus now include a "Mark as Unread" option
• Terminal file links open in file viewer - Clicking file paths printed in the terminal now opens them in the built-in file viewer by default
• Requested reviewers in workspace hover card - See who has been asked to review your PR directly from the workspace card
• Hover actions for Mastra messages - User messages in Mastra chat now show quick action buttons on hover
• Browser webview right-click menu - Right-clicking links in the browser pane now shows a context menu with open/copy options
• Intel (x64) macOS support - Desktop app builds are now available for Intel-based Macs
• Recent invoices on billing page - Your last few invoices are now listed directly on the billing settings page
• MCP create workspace from existing branch - The MCP server now supports creating a new workspace from an existing workspace's branch

Bug fixes

• Fixed createBranchWorkspace always failing with "main workspace already exists" , fixed PR tracking for forked repositories , fixed terminal pane spacing and removed xterm right gutter , fixed shell env not applied to GitHub status checks , fixed terminal tab titles masked by password input , fixed branch prefix case preservation to prevent worktree corruption , fixed auth session recovery on sign-in , fixed chat naming pipeline , fixed PR sync to cover last 30 days

Original source Report a problem

Improved Chat View — Now Generally Available

The redesigned chat interface is now generally available to all users. Previously behind early access, the new chat view features refreshed tool call visuals with collapsible panels, improved diff rendering, and cleaner file views. Superset's own MCP tools—tasks, workspaces, and agent sessions—now render as rich, interactive cards directly in the chat. Superset Chat is also available as a first-class agent option with its own launch config and icon.

• Refreshed tool call visuals with collapsible output panels and inline status icons
• Rich UI cards for Superset MCP tool calls (tasks, workspaces, agent sessions)
• Superset Chat available as a built-in agent alongside Claude, Codex, and others
• Markdown rendering for agent question prompts with optimistic answer UX

Open Worktree with Prompt

The new workspace modal has been redesigned with a send-to-agent flow. When creating a worktree you can now write a prompt that gets sent directly to an agent in the new workspace—describe what you want built and the agent starts working as soon as the workspace is ready. The modal also includes a project selector, an import flow for cloning repos, and auto-generated branch names derived from your prompt.

• Write a task prompt when creating a new workspace
• Agent starts working immediately in the new worktree
• Auto-generated branch names from prompt content
• Keyboard shortcut hint (Cmd/Ctrl+Enter) on the create button

Start Project from Template

New users now see a multi-step setup wizard when opening a project for the first time. The onboarding auto-detects environment files and package managers already present in the repo, guides you through running setup scripts, and links to relevant documentation. The new project flow also includes a Next.js Chatbot template option for quick-starting a project from a pre-built starter.

• Multi-step wizard with setup script detection
• Auto-detection of env files and package managers
• Next.js Chatbot project template via vercel/chatbot
• Docs links on each setup step

Improvements

• Mastra agent prompt UI - Agent questions, approval requests, and plans now appear as interactive inline prompts in chat with markdown rendering and optimistic answer UX
• Persist chat model selection - Your chosen model is now remembered across sessions and app restarts
• Superset MCP tools built-in - Superset's own MCP tools are wired in as built-in extras in chat, no manual configuration needed
• Anthropic API key support - You can now supply your own Anthropic API key for Mastra chat sessions
• Pane right-click menu - Right-clicking a chat or browser pane now opens a context menu with common actions
• Open changes pane from file edits - When an agent edits a file in chat, you can jump directly to the changes pane to review the diff
• Cmd+Shift+W closes the active tab - New keyboard shortcut to close whichever pane tab is focused
• Resource monitor on by default - The system tray resource monitor is now enabled for all users out of the box
• File diffs via diffs.com - Edit tool diffs now open in diffs.com by default for a cleaner review experience
• Read-file tool collapsed by default - File read results start collapsed to reduce chat noise
• Windsurf IDE in Open In menu - Windsurf is now available in the "Open in" external editor dropdown
• Native shell integration - Interactive terminals now default to native shell integration for better PATH and environment handling
• Monthly/yearly billing toggle - Pro users can switch between monthly and yearly billing directly from the plans page
• Chat performance improvements - Replaced aggressive polling with a smarter update strategy, reducing scrollback churn and improving rendering speed

Bug fixes

• Fixed race condition dropping agent prompt on new workspace init
• Fixed first chat message send race on pane creation
• Fixed PATH resolution by using interactive login shell
• Fixed existing PR state handling in changes actions
• Fixed new workspace modal text overflow
• Fixed Codex prompt payload being parsed as flags
• Fixed first chat send failing on session create
• Fixed duplicate tool entries in assistant message rendering
• Fixed interrupted response preview in mastra chat
• Fixed first chat message not rendering immediately during session init
• Fixed chat auto-scroll on resize

Original source Report a problem

Copilot, Cursor Agent, and Gemini Support #1630 #1625 #1620

Copilot, Cursor Agent, and Gemini Support

Superset now supports Copilot, Cursor Agent, and Gemini CLI alongside Claude, Codex, and OpenCode. This release adds built-in presets and hook support for Copilot and Gemini, and Cursor Agent is available as a first-class agent option in the multi-agent workflow.

• Ready-to-use terminal presets for Copilot and Gemini CLI
• Cursor Agent support available now in agent selection and commands
• Correct defaults per agent (--allow-all for Copilot, -y for Gemini)
• Superset notification hooks surface agent task completions in the UI

Configurable Worktree Location #1626

Configurable Worktree Location

Set a custom base directory for new worktrees in Settings > Behavior. You can also override this per-project in Project settings. The per-project setting takes precedence, with a reset option that falls back to the global default.

Custom worktree location settings

New Project Page #1623

New Project Page

Project creation now has a dedicated full-page experience instead of a dialog. Navigate to it from the welcome screen or sidebar footer and choose between two options available now: create an empty Git repo or clone from a URL. A template starter tab is visible and marked "coming soon." A directory picker defaults to
~/.superset/projects
with a native browse button.

Chat UI Overhaul (Early access only) #1693 #1697

Chat UI Overhaul (Early access only)

The chat interface got a significant visual refresh. Streaming messages now animate with a progressive typing effect, tool output panels are collapsible to reduce noise, and loading/thinking states use a unified compact shimmer. The input composer has been redesigned with pill-shaped toolbar buttons, a circular submit button, and a cleaner layout with a hint row showing @ mentions and /commands shortcuts.

• Progressive typing animation for streaming messages
• Collapsible tool output panels with inline status icons
• Pill-style controls for model picker, permission mode, and thinking toggle
• Permission mode labels clarified: Auto, Semi-auto, and Manual

More Improvements

• Open links in app - New toggle in Settings > Behavior routes chat links and terminal URLs to the built-in browser pane instead of your system browser
• Drag file paths into chat - Drag files from the file tree or changes panel directly into the chat input to insert the path as text
• Cmd+F in markdown viewer - Full-text search now works in rendered markdown documents
• Task search persisted in URL - Task search query survives navigation and page refreshes
• Chat scrollback rail - A scroll position indicator appears when browsing older messages in chat
• Copy commit hash - Right-click a commit header in the diff view to copy its hash
• Tray quit confirmation - Quitting with active daemon sessions now prompts whether to keep or kill them
• Clear workspace status - Added "Clear status" to the workspace context menu
• Mouse side buttons - Back/forward navigation now works with mouse side buttons
• Slack image attachments - The Slack agent can now send image attachments

Bug fixes

Fixed 503 errors on new worktrees, fixed sidebar workspace close button not clickable, fixed workspace hover controls layout drift, fixed stale "has uncommitted changes" status in delete dialogs, replaced blocking terminal connection error popup with auto-retry, persisted task filters across navigation, fixed TLS verification in terminal on macOS via SSL_CERT_FILE fallback, added lightweight fallback for PR detection

Original source Report a problem

Chat - Still in preview #1413

Chat got a major upgrade this week. Streaming responses now support interactive tool-approval flows, so you can review and approve each tool call as it happens. A new multi-provider model picker lets you choose between providers and models. Agent and tool calls render as expandable UI blocks with tool-specific displays, and a new web search tool lets Claude fetch and reference live content.

We also shipped a series of fixes to MCP connectivity — replacing the stagnant
mcp-handler
library with a direct SDK transport
#1518
, fixing OAuth connections through the reverse proxy
#1512
, and resolving SDK version conflicts that caused session failures
#1515

#1516
.

Chat with tool approval

In-App Browser #1519

Browse documentation, preview dev servers, and test web apps without leaving Superset. The new embedded browser includes Chrome-like URL autocomplete with browsing history, favicon capture, and DevTools support.

• Navigate directly from detected ports — click the external link icon to open in a browser pane instead of your system browser
• URL bar with persistent history and keyboard navigation
• Clear browsing data from the overflow menu
• Open browser tabs with Cmd+Shift+B hotkey

In-app browser

Desktop Automation Tools #1481

Added MCP-based automation tools that let Claude Code interact with the Superset UI programmatically. Claude can now take screenshots, click UI elements, type into fields, and inspect the DOM — enabling fully automated testing and debugging workflows through natural language.

Improvements

• Linux desktop support - Superset Desktop is now available on Linux with full auto-update support via AppImage builds

#1477

• Terminal context menu - Right-click to copy selected text or paste from clipboard

#1509

• Workspace visual identity - Each workspace gets a unique colored dock icon border for quick visual identification in development

#1478

• Open tasks in workspace - New "Open in workspace" button in task detail creates a workspace and launches Claude with full task context

#1473

• Ahead/behind indicators - See commit sync status directly on workspace items in the sidebar

#1496

• Preset hotkey tooltips - Keyboard shortcuts now visible when hovering over preset bar items

#1469

• Branch name sanitization - Git branch names now preserve valid characters like underscores, dots, and at signs

#1470

• Port allocation improvements - Generated ports.json with human-readable labels, moved allocation to shared file for CLI workflows

#1479

Bug fixes:

• Fixed device presence timezone display

#1521
, improved error reporting for bulk operations
#1522
, fixed stale port data race condition
#1497
, showed diffs against base branch in sidebar
#1495
, prevented row click navigation on dropdown cells
#1468
, preserved permission status when tab focused
#1465
, invalidated workspace nav queries after reorder
#1474
, fixed macOS notification center registration
#1492
, killed orphaned terminal daemon processes during teardown
#1480
, only showed active ports in sidebar
#1488
, fixed canary crash from PostgresStore
#1510
, removed Electric proxy and reverted to API proxy
#1501
, fixed docs search API crash
#1467
, resolved conflicting drizzle migrations
#1482

Original source Report a problem

New Diff View, Powered by diffs.com

New Diff View, Powered by diffs.com

#1308

The Changes view has been completely rebuilt with
Pierre Computer's diffs.com
engine — delivering a drastically improved diff experience in both UI and performance. Large changesets that previously lagged now render instantly, and the new interface makes reviewing diffs feel native and fluid.
The new viewer includes an edit mode toggle — switch between read-only review and live editing, and hit Ctrl+S to save changes directly from the diff.

• Workspace-scoped base branch — base branch selection is now per-workspace instead of global, so diffs always compare against the right branch

#1329

• Preserved file explorer state — expanded folders, scroll position, and selection persist when switching between Changes and Files tabs

#1297

• Compact tab buttons — Changes and Files tabs collapse to icon-only mode with tooltips when the sidebar is narrow

#1334

Early Preview of Chat GUI

#1309

Early Preview of Chat GUI
A native AI chat interface built right into Superset — and it works with your existing Claude Code sessions. Pick up where you left off without switching windows.

• Existing session support — scan and restore previous Claude Code sessions so you never lose context
• Slash commands — type

/

to browse available commands with fuzzy search and keyboard navigation

• File mentions — tag files with

@

and fuzzy search to pull in exactly the context you need

#1307

• Rich tool rendering — tool calls display with specialized UI for bash output, web searches, file diffs, and user questions
• Session persistence — chat sessions survive app restarts with local storage and automatic restore

#1287

This is an early preview — general availability is coming next week. We'd love your feedback in the meantime.
Chat GUI with slash commands and tool rendering

Powerful Preset Settings

#1320

Powerful Preset Settings

#1320

Terminal presets now have granular auto-apply controls. Configure when presets run independently for workspace creation and new tabs — so you can auto-run setup commands on new workspaces without them firing every time you open a tab.

• Apply preset on workspace creation — controls initialization commands when spinning up workspaces
• Apply preset on new tab — controls whether presets run when opening new tabs, panes, or splits
• Explicit preset launches via hotkey or menu always work regardless of these settings
  Improvements
• Improved new tab buttons — grouped outline button bar for New Terminal and New Chat with keyboard shortcuts (Cmd+T, Cmd+Shift+T)

#1321

• Setup script card — persistent sidebar card replaces toast for missing setup scripts with direct link to configuration

#1270

• Push auto-setup — first

git push

from worktrees automatically creates remote branch and sets upstream

#1267

• Project image toggle — hide/show project GitHub avatars in sidebar with colored initial letters as fallback

#1276

• Teardown logs modal — failed teardown scripts show logs in a modal instead of dumping output in error toast

#1277

Bug fixes:

#1323

Fixed circular import in Paywall module

#1322

, processed pending terminal setups for already-initialized workspaces

#1289

, made teardown resilient to already-deleted Neon branches

#1291

, improved auto-updater diagnostics

#1283

, fixed chat infinite re-render

#1319

, routed member creation through Better Auth hooks for billing

#1317

, used bundle IDs for multi-edition JetBrains IDEs

#1313

Original source Report a problem

Performance & Memory Leak Fixes

This release focuses on stability and speed improvements across the app.

Workspace deletion

12x faster - Deletion now completes in ~4-5 seconds instead of ~60 seconds. Terminal shutdowns and cleanup run in parallel, and git worktree removal uses a non-blocking background process.

Port scanning performance

Batched port scans per interval to reduce CPU usage and improve responsiveness

Memory leak fixes

Fixed memory leaks in terminal session management and workspace cleanup routines, reducing memory usage during long sessions

xterm viewport fixes

Resolved terminal viewport height issues that caused rendering problems

File Explorer #1112

File Explorer

Browse and manage your project files directly from the right sidebar. The new file explorer includes a hierarchical tree view, search functionality, and full file operations.

• Create, rename, delete, move, and copy files with context menus
• Toggle hidden files and refresh directory listings
• Search files with instant results and collapsible tree navigation

Terminal Upgrades

• xterm.js 6.0 - Terminal now uses the latest xterm.js with improved rendering and WebGL support

• Copy without trailing whitespace - Terminal text selection now trims trailing spaces when copying, matching iTerm2 behavior

• International keyboard support - Option+key combinations now work correctly on international keyboards (Option+2 = @)

• Session persistence improvements - Terminal sessions now consistently use daemon-backed persistence for better reliability

Improvements

• Changes sidebar redesign - Consolidated header with base branch dropdown and synced expand/collapse state
• Tab navigation hotkeys - Jump directly to tabs 1-9 using ⌘⌥1-9
• Settings keyboard shortcut - Open settings with ⌘, (or Ctrl+, on Windows/Linux)
• Documentation links - Added documentation links throughout the app (Help menu, API Keys, Integrations)
• Tasks search shortcut - Press Cmd+F to focus task search input
• Bulk workspace operations - MCP tools now support creating, updating, and deleting multiple workspaces in one call
• Slack bot web search - Slack bot can now search the web when answering questions
• Slack response formatting - Split Slack bot responses into summary + side effects messages
• Copyable toasts - Toast notifications now allow text selection and copying

Bug fixes

• Fixed git worktree push reliability, fixed case-insensitive filesystem errors during git fetch, fixed MCP date serialization, resolved Claude session heredoc delimiter conflicts

Original source Report a problem

Terminal Tab Arrangement #980

Terminal Tab Arrangement

#980

• Enable drag-and-drop tab reordering for improved workspace organization
• Display keyboard navigation hints in tooltips for adjacent tabs
• Auto-generate branch names from workspace titles when creating workspaces

Docs and Blog Support #974

Docs and Blog Support

#974

• Refactor docs sidebar with simplified section/item structure
• Update navigation bar logo to link to marketing URL
• Add dotenv for loading env vars during development
• Add overscroll-none to prevent pull-to-refresh behavior
• Fix marketing redirect to use env var for docs URL

Ghostty Terminal Support #950

Ghostty Terminal Support

#950

• Added Ghostty application integration to the desktop application's file opening capabilities. Users can now select Ghostty from the list of available applications when using the "Open In" functionality to open files with their preferred terminal application.

Original source Report a problem

Expanded Changes Sidebar #858

Expanded Changes Sidebar
#858

• New workspace layout with a resizable sidebar and improved expand/collapse behavior
• Main content switches cleanly between tab view and changes view
• Added a placeholder "changes" view for upcoming code-review support

Organization Settings #820

Organization Settings
#820

• Desktop: pick an image file to set organization logo (preview + upload)
• Organization settings: edit name, manage slug with live availability checks (owner-only)
• Members: invite, view, sort, and manage organization members with role-aware actions
• Settings navigation reorganized from team-centric to separate Organization and Members sections

Diff View Improvements #845

Diff View Improvements
#845

• Added ability to toggle visibility of unchanged regions in the diff viewer
• Users can now hide unchanged lines to focus on actual changes, improving readability of large diffs
• New toggle button added to the file viewer toolbar with visual state indication

Middle-Click to Close Tabs #853

Middle-Click to Close Tabs

• Added middle-click support for tabs—users can now close a tab by middle-clicking on it for quicker navigation. Matches standard browser tab behavior.

Original source Report a problem

Task List View #717

Task List View

• Added semantic search capabilities for tasks using embeddings
• Introduced dedicated task status management system with custom workflows
• Redesigned tasks interface with table-based view and improved organization
• Enhanced task filtering and sorting by status, priority, and assignee

Diff Highlights in Scrollbar #725

Diff Highlights in Scrollbar

• Enable Monaco's overview ruler in the diff viewer to show colored markers in the scrollbar. Additions (green) and deletions (red) are now visible in the scrollbar for quick navigation.

Shell Environment Fix #720

Shell Environment Fix

• App now captures and applies the user's shell environment on macOS/Linux during startup
• Terminal-related settings (like PATH and ZDOTDIR) are now available when launching from Finder/Spotlight
• Improved handling and merging of PATH entries to prevent terminal initialization issues

Scroll to Bottom Button #700

Scroll to Bottom Button

• Add a floating scroll-to-bottom button that appears when the terminal is scrolled up. Button uses a chevron icon and animates in/out smoothly. Shows keyboard shortcut in tooltip when available.

Original source Report a problem

Sidebar Overhaul #601

Sidebar Overhaul
#601

• GitHub avatar support in project thumbnails
• Collapsible workspace sidebar with icon-only compact mode and improved toggle/collapse behavior
• Richer project headers and compact thumbnails
• Updated sidebar/list item layouts, icons, spacing, and sizing across many panels

Workspaces Page #599

Workspaces Page
#599

• Added a searchable, filterable workspaces list view with grouped project headers and per-workspace rows
• New workspace row UI showing status, diffs, timestamps, and reopen/opening states
• Project headers now offer a context menu: Open in Finder, Project Settings, Close Project
• Workspace sidebar header is now a clickable toggle and the workspaces list auto-closes on selection

Workspace Status Indicators #588

Workspace Status Indicators
#588

• Add 3-color workspace status indicators showing agent lifecycle (amber=working, red=permission needed, green=ready for review)
• Integrate with Claude Code hooks and OpenCode plugin for real-time status updates
• Click behavior: review → idle (acknowledged), permission → working (assumes permission granted)

PR Status in Changes View #608

PR Status in Changes View
#608

Add a PR status indicator (icon + number) to the Changes view header that links to GitHub. Color-coded PR icons based on state (green for open, violet for merged, red for closed, muted for draft).

Original source Report a problem