0.4.3

🚀 Major New Features

External Terminal Management

• 🖥️ Introduced configurable external terminal profiles with support for Terminal, iTerm2, and Warp
• 🎨 Implemented dynamic terminal profile selection based on installed applications
• 📦 Added terminal profile store supporting bundled and user-defined configurations
• 🔍 Enhanced bundle identifier management and app availability checks
• 🎯 Unified terminal menus across different session types

Advanced Settings & CLI Management

• ⚙️ Added new Advanced Settings page with tabbed interface (Path and Dialectics)
• 🔧 Implemented CLI command path management for Codex, Claude, and Gemini with optional user overrides
• 📊 Enhanced CLI environment detection and PATH resolution
• 🔍 Added CLI version detection and display in settings
• 🛡️ Improved sandbox-aware PATH handling for better CLI resolution

Codex Usage & Account Management

• ✨ Implemented Codex usage probing via app-server to fetch rate limits and account plan information
• 🎯 Added account plan badge display (Plus/Pro) in Codex usage status control
• 🔄 Enhanced usage status with app-server data merged with session token count fallback
• 🔍 Added refresh action for Codex empty state to manually trigger usage probe

Model Updates

• 🎯 Updated default Codex model to gpt-5.2-codex across the application
• 📋 Reordered builtin models to prioritize gpt-5.2-codex as the first/default option
• 🔄 Updated model alias mapping to point gpt-5-codex to gpt-5.2-codex for backward compatibility

Gemini Integration Enhancements

• 🔍 Enhanced Gemini session diagnostics with presence detection and version checking
• 🎯 Improved Gemini CLI session filtering to match official CLI behavior
• 🔧 Stabilized resume working directory resolution for Gemini sessions
• 📊 Integrated Gemini diagnostics into Dialectics pane UI
• 🐛 Fixed session parsing to skip info-only sessions and prevent cache purging on unknown parse failures

Session Management Improvements

• ⚡ Optimized session handling with scoped project IDs and directories based on date dimension
• 🔄 Enhanced caching logic for better session merging and note application
• 📋 Improved refresh logic to conditionally trigger based on selected date dimension
• 🎯 Refined session indexing for better date range and cached data retrieval
• 💾 Enhanced cached summary completeness status in Gemini session provider

Command Copying Enhancements

• 📋 Enhanced command copying functionality with conditional clipboard operations
• 🔔 Improved command copying notifications respecting user preferences
• 🎯 Unified command copying behavior across different session types and terminal profiles
• 🔧 Simplified command copying checks across multiple views for better maintainability

⚡ Performance Optimizations

• 🚀 Optimized session handling and project filtering logic with scoped data processing
• 💨 Improved caching strategy for session merging and note application
• 🛡️ Enhanced refresh debouncing based on date dimension selection
• ⚙️ Better handling of cached summaries with completeness status tracking

🐛 Bug Fixes

• 🎯 Fixed usage hover timing to gate until collapse animation completes
• 🔄 Stabilized Gemini resume working directory resolution
• 📁 Improved Gemini session filtering to match CLI behavior
• 💾 Enhanced cached data retrieval and completeness tracking
• 🔧 Fixed command copying flow for external terminals

🎨 UI/UX Improvements

• 🎨 Enhanced usage status control with account plan badge display
• 📊 Improved diagnostics UI for Gemini sessions
• 🔧 Unified terminal menu experience across different contexts
• 📝 Enhanced command copying notifications and user feedback
• 🎯 Improved settings organization with new Advanced Settings page

🔧 Technical Improvements

• 📦 Downgraded minimum macOS deployment target from 15.0 to 13.5 for broader compatibility
• 🏗️ Refactored terminal management from enum-based to profile-based architecture
• 🔍 Enhanced CLI environment utilities with better PATH resolution
• 📊 Improved diagnostics service with Gemini session support
• 🛡️ Better sandbox-aware file system access handling

📊 Change Statistics

• Files Changed: 43 files
• Code Changes: +3,206 / -1,177 lines
• Major Commits: 13 feature and refactoring commits

📝 Documentation

• 📖 Updated AGENTS.md to reflect CLI integration and advanced settings changes
• 🔧 Documented external terminal profile management system
• 📋 Updated CLI command path management guidelines

---

Upgrade Recommendation: This release includes significant improvements to terminal management, CLI path handling, and Codex usage tracking. The macOS deployment target has been lowered to 13.5, making the app compatible with older macOS versions. External terminal profiles are now fully configurable, providing better flexibility for different terminal preferences.

0.4.2

🚀 Major Updates

Session Indexing & Refresh (Faster “Others”)

• ⚡ Faster “Others” refresh + indexing: runs incremental refresh for Codex / Claude / Gemini concurrently to reduce overall refresh latency
• 🔍 More reliable “new sessions today” discovery: in the updated-day fast path, the indexer now also enumerates the created-day directory (in addition to cached/SQLite-backed records) to avoid missing brand-new sessions that haven’t been persisted yet
• 🧠 Fewer unnecessary UI updates: avoids re-publishing active-updating ID changes when the computed set is unchanged, reducing UI churn

Terminal / Warp Resume Workflow

• 🧾 Improved Warp resume title UX: generates a stable Warp title hint derived from user title / project scope / task, and prompts when needed to confirm/override
• 🛡️ Safer failure handling: if Warp title input is cancelled/invalid, external-open flow aborts early to avoid opening Warp without usable commands
• 🔧 More flexible command generation: Warp resume command building now supports an explicit titleHint (covers both local and remote/SSH scenarios)

Codex Default Model Update

• 🤖 Default Codex model updated to gpt-5.2
• 🧩 Built-in model list now includes gpt-5.2, and the bundled Providers payload default model is updated accordingly
• 🔁 Alias resolution: gpt-5 / gpt5 now maps to gpt-5.2

Project List Editing Decoupling (UI Structure)

• 🧱 ProjectsListView removes internal “edit sheet” state and switches to an onEditProject callback so the parent can present the editor
• 🖱️ Double-click and edit actions now consistently route through the callback, improving modularity and separation of concerns

🧰 Engineering / Build

• 🛡️ Hardened Xcode 16 build settings: enables Hardened Runtime and updates related project/scheme upgrade settings
• 🔏 Adds CodeSignOnCopy for codmate-notify in the Copy Files phase for more reliable distribution/runtime behavior

📝 Documentation

• 📖 Major README improvements: clearer product positioning (CLI AI session manager), expanded feature overview, usage/navigation details, data locations, and architecture/performance notes
• 🖼️ Updated app screenshot (screenshot.png)

📊 Change Statistics (v0.4.1 → HEAD)

• Commits: 6
• Files Changed: 18
• Code Changes: +249 / -106 lines (plus 1 binary update: screenshot)

🧾 Notable Commits

• feat: accelerate Others refresh and indexing
• feat: improve Warp resume workflow
• feat: adopt GPT-5.2 as default Codex model
• feat: refactor ProjectsListView to use callback for project editing
• chore: harden macOS build settings for Xcode 16
• docs: enhance README with comprehensive app overview and features

---

Upgrade Note: This release primarily improves refresh/indexing performance and stabilizes the Warp external-terminal workflow. Risk is low, but note the default Codex model has changed to gpt-5.2.

0.4.1

🚀 Major New Features

Warp Terminal Integration

• ✨ Enhanced session command handling with destination app parameter support for Warp terminal integration
• 🎨 Introduced WarpTitleBuilder for generating formatted tab titles for new sessions and projects
• 💬 Added user prompt functionality for custom Warp tab titles, providing flexible session management
• 🔄 Improved Warp resume workflow for smoother terminal session handling
• ⚙️ Enhanced UI components with toggle options for prompting Warp title input

Model Updates

• 🤖 Adopted GPT-5.2 as the default Codex model for improved performance and capabilities

⚡ Performance Optimizations

• 🚀 Accelerated "Others" category refresh and indexing operations
• ⚡ Optimized session indexing mechanism for faster data retrieval

🛠️ Build & Development

• 🔧 Hardened macOS build settings for Xcode 16 compatibility
• 🏗️ Updated project schemes and build configurations for improved stability

🔄 Code Refactoring

• 🏛️ Refactored ProjectsListView to use callback-based project editing architecture
• 📦 Improved modularity and separation of concerns in project management components
• 🎯 Streamlined project editing process with external callback handling

📊 Change Statistics

• Files Changed: 23 files
• Code Changes: +643 / -136 lines
• Major Commits: 6 feature commits

📝 Technical Details

Warp Integration Enhancements

• Session commands now support destination app parameter for Warp-specific command generation
• Custom tab title prompts allow users to create meaningful session identifiers
• Title builder automatically formats project names, task descriptions, and timestamps into URL-friendly slugs

Performance Improvements

• Optimized indexing strategy for "Others" category sessions
• Enhanced refresh logic to reduce redundant operations

Build System Updates

• Updated Xcode project settings for Xcode 16 compatibility
• Improved build scheme configurations for different deployment targets

---

Upgrade Recommendation: This release focuses on Warp terminal integration and performance improvements. The new GPT-5.2 model provides enhanced capabilities, and the Warp integration features offer better terminal workflow management. No breaking changes are expected, and the upgrade should be seamless.

0.4.0

🚀 Major New Features

MCP Server Management

• ✨ Added target management functionality, supporting configuration of enabled targets (Codex, Claude, Gemini) for each MCP server
• ✨ Implemented Codex feature flag management system with dynamic fetching and override capabilities
• 🎨 Enhanced MCP server settings interface for a more intuitive configuration experience

Session Management Enhancements

• 📋 Session list now supports displaying project instruction previews
• 🔄 Introduced session version tracking mechanism to ensure state consistency
• ⚡ Optimized session indexing and caching system, significantly improving load performance
• 🔍 Improved refresh logic for Codex and Claude sessions

Project Management

• 🖱️ Added context menus for quick creation of projects and sessions
• 🤖 Implemented automatic session assignment based on directory matching
• ✅ Enhanced task management with new task creation options and context menus

Activity Charts

• 📅 Support for date selection filtering by clicking on dates
• 📊 Added token count metrics, supporting trend viewing by token usage
• 📈 Optimized data aggregation logic for improved statistical accuracy

Token Management

• 🔢 Introduced detailed token breakdown (input, output, cache read, cache creation)
• 🎯 Replaced old calculation method with actualTotalTokens for improved accuracy
• 📝 Optimized message structure to support token details for assistant messages

Indexing and Caching System

• 💾 Implemented SQLite-based session data storage
• 🔍 Support for fine-grained data retrieval based on date and project
• 📄 Implemented pagination and incremental loading mechanisms
• ⚡ Optimized cache invalidation and refresh strategies

Gemini Integration (WIP)

• 🔌 Added Gemini usage status tracking
• 🔑 Implemented Gemini API client
• 🎨 Integrated Gemini metrics into usage status controls

Git Integration

• 📄 Implemented paginated loading for commit history
• ⬇️ Support for on-demand incremental loading of more commits
• 🔍 Added branch search functionality

⚡ Performance Optimizations

• 🚀 Optimized session indexing mechanism using memory-mapped reads
• 💨 Improved disk cache strategy, prioritizing cache hits
• 🛡️ Implemented refresh debouncing to reduce redundant operations
• 📦 Batch UI updates (approximately 10 items per batch)
• ⚙️ Use lightweight mtime pulses to maintain update indicators

🐛 Bug Fixes

• ✏️ Fixed typos in codemate-notify script
• 🎯 Ensured a session is always selected in the middle list
• 💾 Fixed timeline card state preservation issues
• 🔄 Avoided batch state updates during initialization and refresh
• 📁 Fixed project file references and casing issues

🎨 UI/UX Improvements

• 💬 Use conversation bubble icons
• 📝 Project overview supports multi-line input
• 📏 Unified form alignment and layout
• 🔔 Added real-time activity and follow-up indicators
• 🎯 Unified icon style, using sync symbol for info events
• 📊 Optimized usage status control layout and readability

📊 Change Statistics

• Files Changed: 61 files
• Code Changes: +9,483 / -1,190 lines
• Major Commits: 17 feature commits

📝 Documentation

• 📖 Established and updated AGENTS.md development guidelines
• 📸 Updated README and added application screenshots

---

Upgrade Recommendation: This release includes multiple major refactorings and performance optimizations. It is recommended to backup data before upgrading. Some features (such as Gemini integration) are marked as WIP and will be refined in future releases.

0.3.0

• Global Search & Indexing

  • Introduced the global search overlay with selectable panel styles, backed by ripgrep-based indexing for fast analytics and filtering.
  • Kept Git Review usable without a repo by adding explorer search fallbacks and optimized session counting/file filtering.

• Remote & Provider Enhancements

  • Added SSH-based remote session mirroring plus a dedicated Remote Hosts settings page.
  • Expanded provider support with Claude/Codex notification hooks, provider-origin usage tracking, and default model upgrades (gpt-5.1 family including gpt-5.1-codex-max).

• Projects & Tasks System

  • Implemented project-centric workspace modes with persistent state, drag-and-drop hierarchy editing, and richer empty states.
  • Shipped a full task management surface (grouping, drag/drop, automatic context sync) and refined Projects/Tasks UI interactions.

• Git Review Upgrades

  • Delivered Git graph visualization, a commit detail panel (file tree, diff, fetch/pull/push), and discard semantics aligned with VS Code.
  • Unified review toolbars, added path copy actions in diff-tree menus, and improved staging/unstaging flows.

• Overview & Analytics

  • Created AllOverview and Project Overview surfaces with new activity chart models and smart calendar defaults.
  • Synchronized filtered statistics globally so sidebar counts and calendars refresh instantly.

• Gemini Ecosystem Integration

  • Added complete Gemini session ingestion: parsing, environment context loading, global search, and settings UI.
  • Extended ContextTreeshaker and timeline loaders to understand Gemini-specific segments.

• User Experience Improvements

  • Standardized search bars/toolbars across Tasks and Review, introduced shared collapse/expand controls, and tightened icon handling.
  • Added path-copy utilities, better running/updating indicators, improved empty states, and gentler settings interactions (debounced sandbox toggles).

0.2.0

• Features: Added gpt-5-codex-mini default wiring and the new kimi-k2-thinking provider slot so users can choose
  both models across settings, providers, and CLI resume flows.
• Features: Usage capsule now surfaces full Codex/Claude telemetry with richer status text, duplicate suppression,
  and updated Claude log parsing so hover/popover refreshes show live 5h/weekly limits.
• Features: Embedded terminal batching + drag-insert enhancements and a streamlined Git Review tree/panel
  dramatically smooth large-repo workflows.
• Features: Detail panes keep independent Timeline/Terminal/Review tabs per session, CLI path handling is hardened,
  and terminal font/cursor customization is exposed.
• Refactors: Sidebar/project selection switched to snapshot-driven Equatable containers, and UsageStatusControl +
  sidebar scaffolding were reorganized for predictable diffing.
• Fixes: Per-session detail tab state no longer bleeds across sessions, eliminating surprise tab jumps after
  navigation.
• Performance: Sidebar/path tree/terminal rendering now relies on cached digests + incremental PathTreeStore
  updates, cutting AttributeGraph/Metal churn; Claude usage parsing runs off the main actor for snappier refreshes.

0.1.9

• feat: add sandbox-aware permissions pipeline with security-scoped bookmarks and distribution-aware UI surfaces
• feat: bundle default provider templates and refresh Providers/Codex settings flows for quicker onboarding
• feat: introduce repository browser mode inside Git Review with stage/unstage, open, and reveal actions
• refactor: split GitChangesPanel into focused SwiftUI extensions to tame compile times and navigation
• fix: tolerate fractional timestamps in session loaders to prevent timeline parsing failures
• build: set up CodMate (Direct)/(MAS) schemes and scripts for notarized DMG, MAS, and aggregate macOS builds
• build: disable App Sandbox for Direct configs so language servers and subprocess tooling can spawn normally
• build: auto-select scheme/config and switch to manual signing when SANDBOX=off in macOS build script

0.1.8

• feat: introduce full-area Git Review mode with Git service integration (staged/unstaged lists, unified diff/file preview, commit box)
• feat: add Cmd+1 / Cmd+2 shortcuts to toggle Projects sidebar and Sessions list
• feat: move project and session deletions to Trash for safer recovery
• refactor: update SessionListViewModel filter updates on main actor to eliminate SwiftUI warnings

Introduce Git Review

• feat: AI-powered commit message generation (OpenAI/Anthropic compatible; wand button; debounced)
• feat: customizable commit message prompt template (persisted in settings)
• feat: viewer preferences: line-numbers and soft-wrap, persisted per user
• feat: bulk Stage/Unstage All with independent tree expansion for staged vs unstaged
• feat: persist per-session UI state (expanded dirs, selected paths, commit draft)
• settings: new Git Review tab (provider/model pickers, prompt template; viewer prefs)

0.1.7

• feat: add support for opening projects in external editors (VSCode, Cursor, Zed)
• feat: enhance Claude Code support with unsandboxed commands and agent file handling
• refactor: remove user-configurable CLI paths for codex and claude executables.
• refactor: improve new session creation flow with better refresh and terminal handling

0.1.6

• feat: adopt Claude-native permission model in settings and refine labels
• feat: add LiveFileSizeText component for live session file size
• fix: align “Recent” sorting and grouping with selected calendar dimension
• fix: improve terminal focus and command insertion after prompt picker