🚀 Major New Features
Terminal Session Management Overhaul
- ✨ Decoupled terminal sessions architecture with new
HeadlessTerminalSessionclass - 🎯 Fast session switching by decoupling terminal sessions from views for improved performance
- 📊 Active terminal sessions control with toolbar button and popover showing running session count
- 🔄 Enhanced session lifecycle management with proper start/stop tracking and state synchronization
- 🛡️ Race condition prevention with
recentlyStoppedmechanism to avoid session resurrection issues - 📈 Improved scrollback management with dynamic pin/unpin support and aggressive memory optimization for background sessions
- 💾 Optimized data flushing with chunked processing and typing-aware flush windows for better responsiveness
Dock File Handling
- 📁 Folder drag-and-drop support - drop folders onto Dock icon to create new projects
- 🎯 DockOpenCoordinator for managing new project requests from Dock operations
- 📋 Enhanced Info.plist with
CFBundleDocumentTypessupport for folder document types - 🔗 Improved session resumption logic to accommodate embedded terminal preferences from Dock launches
Menu Icon System Infrastructure
- 🎨 Core menu icon support with asset images and system images
- 🌓 Dark mode inversion support for ChatGPTIcon and other provider icons
- 📐 Standardized 14x14pt icon size for consistent menu item appearance
- 🔧 Extended SplitMenuItem.Kind to accept
systemImageandassetImageparameters - 🎯 Provider icons in menus - ChatGPT, Claude, and Gemini icons now appear in menu items
Terminal Selection Enhancements
- 🔄 Menu-based terminal selection for Resume operations (embedded vs external terminal profiles)
- 🎯 Embedded terminal integration in Resume and New Session menus when available
- ⚙️ Terminal profile support for task context session launches
- 📋 Enhanced menu items with terminal selection options in TaskListView and SessionListColumnView
🎨 UI/UX Improvements
Menu Bar Enhancements
- 🎨 Dynamic icon updates based on usage data and menu state
- 🌓 Appearance observation to regenerate menu bar icon when system appearance changes (including wallpaper-based tinting)
- 🔄 Real-time menu updates when menu is open to reflect current usage data
- 🎯 Improved icon rendering with adaptive colors (white/black) based on menu bar button appearance
- 📈 Enhanced Retina rendering with 4x/6x scale for better anti-aliasing
- 🔄 Refreshable usage items with clickable refresh action in menu
Conversation Timeline
- 🎯 Improved sticky header interaction by moving gesture handlers to inner content
- 📐 Better tap area and visual indication for expand/collapse state
- 🖱️ Enhanced hover effects with proper content shape for better interaction
Task List View
- 🎨 Enhanced context menus with icons and improved organization
- 🔄 Menu-based session creation with terminal selection options
- 📋 Improved "Collaborate with" menu with provider icons and terminal profile selection
- 🎯 Better menu item labels with system icons for consistency
Active Terminal Sessions Control
- 📊 Toolbar button displaying active session count with badge
- 🔍 Popover interface for quick access to running terminal sessions
- 🔄 Real-time updates via notifications and polling (1.5s interval)
- 🎯 Session list showing terminal keys and start times
Split Controls
- 🎨 Enhanced menu rendering with icon support
- 🔧 Improved menu item consistency across the application
🔧 Technical Improvements
Architecture
- 🏗️ HeadlessTerminalSession for decoupled terminal session management
- 🎛️ TerminalSessionManager refactoring from view-based to session-based architecture
- 📦 DockOpenCoordinator for centralized Dock file/folder handling
- 🔄 Notification-based state synchronization for terminal sessions updates
- 📊 Active sessions query API with
getActiveSessions()andgetActiveSessionsCount()methods
Performance Optimizations
- ⚡ Optimized scrollback management with dynamic size adjustment (1,000 lines minimum for background, restored to target when attached)
- 💾 Memory optimization by aggressively shrinking scrollback for background sessions
- 🔄 Improved data flushing with chunked processing (8KB max drain, 12 chunks max)
- ⏱️ Typing-aware flush windows (80ms) for better responsiveness during user input
- 🚀 Faster session switching by keeping sessions alive when not visible
Code Quality
- 🧹 Removed view dependencies from TerminalSessionManager
- 📝 Improved error handling and state management
- 🔍 Enhanced logging for terminal session lifecycle events
- 🛡️ Thread safety improvements with
@MainActorannotations for Dock handlers
🐛 Bug Fixes
Terminal Session Management
- 🔧 Fixed session resurrection race condition preventing immediate restart of stopped sessions
- 🎯 Improved terminal display priority to show focused session's terminal first
- 🔄 Fixed visibleTerminalKeyInDetail() to correctly identify active terminal
- 🛡️ Enhanced stopEmbedded() to support both session ID and terminal key
UI Fixes
- 🎯 Fixed sticky header gesture handling in ConversationTimelineView
- 🖱️ Improved hover interaction with proper content shape
- 🌓 Fixed dark mode visibility for menu bar icons with appearance-based color adaptation
Thread Safety
- 🛡️ Added @mainactor to dock folder drop handlers for thread safety when handling drag-and-drop operations
📊 Change Statistics
- Files Changed: 25 files
- Code Changes: +2,083 / -573 lines (net: +1,510 lines)
- New Files:
services/DockOpenCoordinator.swift(60 lines)services/HeadlessTerminalSession.swift(365 lines)views/ActiveTerminalSessionsControl.swift(291 lines)
- Major Refactoring: TerminalSessionManager architecture overhaul
- Major Additions: Terminal session decoupling, Dock file handling, menu icon system
Upgrade Recommendation: This release introduces a major terminal session management overhaul that significantly improves performance and user experience. The new decoupled architecture enables faster session switching and better resource management. Users will benefit from the new active terminal sessions control, improved menu icons, and Dock file handling capabilities. The scrollback optimization reduces memory usage for background sessions while maintaining full history when sessions are active.