CHANGELOG_

Extended Thinking

• >Claude SDK Integration: Native Extended Thinking support in Claude SDK client
• >ACP Adapter Support: Extended Thinking events in Claude ACP adapter
• >Thinking UI Components: Visual display of AI reasoning process in chat

Parallel Agent Tasks

• >ACP-Based Execution: Parallel tasks run via dedicated ACP sessions, sharing agent connections
• >Provider Modes: Support current agent, connected ACP agents, and direct mode (dynamic agent creation)
• >Event Routing: Session-to-task mapping for proper streaming output routing
• >Task Persistence: LocalStorage persistence with automatic cleanup on hydration
• >Result Merge: Inject parallel task results back into parent chat as user messages
• >Delegate Popover: Click-positioned popover with virtualRef anchoring for precise placement
• >Provider Groups: Organized selection with "Recommended", "Connected Agents", and "Direct Mode" sections

Diff View

• >Center Panel: Dedicated diff panel inserted between Chat and DevTools (previously a DevTools tab)
• >Conditional Rendering: Panel appears only when a file is selected for diff

ACP Runtime

• >Idempotent Connect: Agent connect operation now returns existing info if already connected

Editor Enhancements

• >Mention Suggestions: Enhanced mention suggestions and editor behavior
• >Tiptap Extensions: Added Tiptap extension dependencies for rich text editing

Session History

• >Session Search: Add search functionality to session history

Chat Improvements

• >Force Send: Add force send and timeout handling for queued messages
• >Status Indicators: Improved status indicators and visual feedback

Explorer

• >Modular Components: Extracted modular components from ExplorerPanel

UI/UX Improvements

• >Task Card Styling: Minimal status dots replacing badges, AgentText for streaming content
• >Wizard Interrupt: Improved interrupt handling and clean up UI
• >Focus Ring: Unified focus ring to subtle 1px ring-ring/40

Fixes

• >PTY Buffer: Handle incomplete UTF-8 sequences at buffer boundaries

Editor Improvements

• >Soft Line Breaks: Support Shift+Enter for line breaks within messages (HardBreak extension)

MCP Integration

• >Generic Tool Labels: Parse mcp__server__tool format to display user-friendly labels with server context
• >Smart Deduplication: Hide redundant server suffix when tool and server names match

UI Fixes

• >Branch Item Overflow: Fixed BranchItem overflow in narrow containers with proper width constraints

Slash Command Priority

• >Custom Command Override: Custom and ACP commands now take precedence over built-in handlers
• >Automatic Scanning: Cache custom command names from project and user directories for fast lookup

Context Window Management

• >Circular Progress Indicator: Visual ring showing context usage percentage
• >Token Usage Display: Real-time context usage with circular progress bar
• >Auto-Compaction: Automatic context summarization when usage exceeds configured threshold
• >Manual Compact: /compact command support for on-demand context compression
• >Configurable Thresholds: Settings UI for warning and compaction trigger levels
• >Interrupted Context Restoration: Preserve partial responses on follow-up messages

Sandbox WebView

• >Isolated HTML Execution: Run AI-generated HTML tools in secure sandboxed windows
• >Permission Tiers: Core (window-only) and Extended (OS info, dialogs) permission levels
• >Custom Protocol: sandbox:// protocol with strict CSP headers for security
• >Context Menu Integration: "Run in Sandbox" option for HTML code blocks in chat

Enhanced Message Copy

• >Structured Export: Copy messages preserving interleaved text and tool calls
• >Format Options: "Copy as Markdown" for full structure, "Text Only" for plain content
• >Tool Call Serialization: XML-style formatting for tool calls including nested agents

Chat Improvements

• >Free Text Questions: AskUserQuestion now supports textarea input when no options provided
• >Smart Queue Timing: Queued messages sent after next tool call for safer interruption
• >CJK Token Estimation: Improved token counting heuristics for Chinese/Japanese/Korean text

Git Integration

• >Untracked File Stats: Line counts now include untracked files in git status
• >Binary Detection: Skip binary and large files (>1MB) to prevent UI blocking
• >Streaming Line Count: BufReader-based counting for memory efficiency

Provider & Model Selection

• >Default Provider Preference: Persist preferred provider (Claude/Codex) across sessions
• >Standalone Selector: Provider/model selector works without active session, persisting choice to settings
• >Cross-Provider Selection: Automatic provider inference when selecting models from different providers

Codex Agent

• >Updated Approval Policies: Aligned with upstream (Untrusted, OnFailure, OnRequest, Never)
• >Mode Policy Mapping: Architect/Code use OnRequest, Ask uses Untrusted, Custom uses Never

UI/UX Improvements

• >Branch Collapse: Explorer shows top 3 recent branches with popover for others
• >Code Block Overflow: Fixed horizontal overflow in AgentText and ToolCallCard
• >Portal Popover: FloatingCommentPopover uses portal to avoid backdrop-filter issues
• >Progress Customization: Added indicatorClassName prop for custom progress bar colors
• >New Window Handling: Clear active project in new windows to show WelcomeScreen
• >Collapsed Terminal: Terminal defaults to collapsed state for cleaner initial layout

Claude Agent Improvements

• >System Prompt Simplification: Condense multiline path instructions into single line
• >Windows Compatibility: Avoid special characters that cause issues with cmd.exe

UI Consistency

• >Text Color Standardization: Replace text-primary with text-foreground in GeneralTab
• >Theme Compatibility: Improved color consistency across light and dark themes

ACP MCP Servers Support

• >MCP Server Configuration: Add McpServerConfig with Stdio/Http/Sse transport types
• >Session Integration: Pass MCP servers to new_session and load_session calls
• >Relative Path Enforcement: Add system prompt to Claude agent enforcing relative path usage

Command Source Badges

• >Available Commands: Display ACP agent commands in editor suggestions
• >Source Disambiguation: Show source badges (Custom/Claude/Caret/Workflow) for commands
• >Priority Ordering: Custom > ACP > Built-in > Workflow command ordering

Mobile Multi-IP Support

• >Network Interface Discovery: List all non-loopback IPv4 addresses
• >IP Selector: Add dropdown to select target IP when multiple interfaces exist
• >Improved Connectivity: Better cross-network mobile connection experience

UI Consistency

• >Text Color Standardization: Replace text-primary with text-foreground across settings tabs
• >Theme Compatibility: Improved color consistency across light and dark themes

Permission Handling

• >Inline Permission Request: Implement inline permission request flow for tool confirmations
• >Tool Confirmation UI: Streamlined confirmation dialogs for dangerous operations

Todo Persistence

• >Session Restore: Add todo list restoration from messages on session load
• >State Recovery: Preserve todo progress across app restarts

UI Polish

• >Component Spacing: Improve spacing and styling across chat components
• >TodoPanel Refinements: Better visual hierarchy in todo indicators and panels
• >Input Cleanup: Remove unnecessary input component attributes

Data Tracking

• >Edited Files Tracking: Track edited files on tool call completion
• >Session Metadata: Enhanced session data storage in database

Nested Task Support

• >Hierarchical Task Rendering: Display parent-child relationships for sub-agent/Task tool calls
• >Recursive ToolCallCard: Render child tool calls within parent cards with visual hierarchy
• >Parent Tracking: Add parent_tool_call_id field for nested task visualization
• >Markdown Output: Parse and render sub-agent results with Streamdown component

Claude Agent Enhancement

• >Text Buffering: Implement buffering mechanism to prevent duplicate Assistant output
• >Nested Task Backend: Add parent_tool_call_id support in SessionUpdate::Text
• >Error Handling: Send error messages as Text before TurnComplete for better UX
• >Debug Logging: Add message flow tracking for easier debugging

Model Configuration

• >Full Date Model IDs: Update Claude model IDs to date-specific versions
  • >claude-sonnet-4-5 → claude-sonnet-4-5-20250929
  • >claude-opus-4-5 → claude-opus-4-5-20251101
  • >claude-haiku-4-5 → claude-haiku-4-5-20251001
• >Cross-Module Sync: Sync model ID changes across frontend, backend SDK, and tests

Performance

• >Git Main Root Caching: Add GIT_MAIN_ROOT_CACHE with 1-hour TTL
• >Reduced FS Calls: Minimize filesystem queries for git main root path
• >Worktree Optimization: Improve worktree operation performance

UI Polish

• >Chat Input Reorder: Move QueuedMessageCard above references for better flow
• >Thinking State: Remove italic style from thinking indicator
• >Dialog Overlay: Add titlebar-interactive attribute for better window interaction
• >Spacing Refinements: Improve QueuedMessageCard spacing and alignment

Markdown Rendering

• >Streamdown Integration: Replace react-markdown with streamdown for improved markdown rendering
• >Code Highlighting: Enhanced code block styling with streamdown CSS

File Edit Tracking

• >Session Edit History: Track edited files per chat session with extractEditedFilesFromMessages utility
• >Incremental Tracking: Monitor Write, Edit, StrReplace, NotebookEdit tool completions
• >Cross-Store Support: Edit tracking in chatStore, wizardChatStore, and workflowChatStore

Full-Text Search

• >VS Code-like Search: New search.rs module with regex, case sensitivity, and whole word options
• >Glob Patterns: Include/exclude file patterns for targeted searching
• >Search UI: SearchSection component with grouped results by file
• >Explorer Integration: New Search tab alongside Files and Issues tabs

Diff View & File Preview

• >FileEditPanel: Display session edited files above chat input
• >SidebarDiffView: Git diff display in right panel with syntax highlighting
• >FilePreviewPanel: File content viewer with syntax highlighting
• >Diff Tab: New 'diff' tab in right panel for viewing file changes

Tab Enhancements

• >Status Indicators: TabStatus with idle/generating/awaiting-permission states
• >Visual Feedback: Spinning loader and ping animation for active states
• >Draft Persistence: Preserve input text when switching tabs
• >File Tabs: Support file tab type with FileText icon

UI Polish

• >Thinking Indicator: Creative loading words during AI thinking
• >Tool Card Improvements: Move edit preview inside ToolCallCard expanded section
• >Line Numbers: Show edit location in EditPreviewCard header
• >Context Menu Spacing: Fix icon spacing in context menus

Startup Performance

• >localStorage Cache: Instant app initialization from localStorage cache
• >Dual Persistence: localStorage for fast startup, Tauri Store as source of truth
• >Session Sync: SessionManager synchronizes localStorage and Tauri Store
• >Zero White Screen: Immediate UI render before async data loads

Branding

• >New App Logo: Replace react.svg with caret.svg in TitleBarMenu

Chat & Messages

• >Message Queue: Allow message queuing during generation with separate send button
• >Stale State Sanitization: Detect and fix zombie streaming messages and running tool calls on startup
• >Model Pinning: Ctrl+Click on model to pin as default preference across sessions
• >Preferred Models Sync: Sync user-pinned models to models module for persistent defaults

Chat Persistence

• >Unified Persistence Module: Merge v1 and v2 into single module with ~55% code reduction
• >WAL Crash Recovery: Migrate Write-Ahead Log recovery to unified module
• >Safe Refresh: Ctrl+R/F5 interception for safe page refresh with data persistence

Auto-Scroll

• >useAutoScroll Hook: Reusable hook for Radix ScrollArea with smart auto-scroll
• >Scroll-to-Bottom Button: Floating button when user scrolls up in chat panels
• >Content Detection: Auto-scroll on new content unless user scrolled up

UI Improvements

• >Layout Overflow Fixes: Proper overflow handling in chat cards with responsive widths
• >ToolLabel Truncation: Fix tool label truncation with proper block display
• >EditPreviewCard Paths: Handle absolute file paths correctly on Windows
• >ACP Tool Tracking: Fix tool_call_id to message mapping for correct status updates

Changelog

• >Modular Changelogs: Extract version content to separate markdown files for maintainability

Agent Permissions

• >Delegated Permission Resolution: Each agent implementation now handles its own permission requests via resolve_permission trait method
• >Claude Agent Support: Permission resolution with Allow/Reject responses in ClaudeAgent
• >Standard ACP Agent: Permission resolution using permission callbacks in StandardAcpAgent
• >Always Allow Support: New get_pending_permission_suggestions helper for "Always Allow" functionality

Preview Inspector

• >Error Handling: Wrap entire inspector script in try-catch for robust error handling
• >Environment Checks: Add guards for window, document.body, and document.head existence
• >Race Condition Fix: Handle DOMContentLoaded race conditions with readyState check
• >Duplicate Prevention: Prevent duplicate initialization via overlay element check
• >Safe DOM Operations: Safely append DOM elements with existence guards

Performance Optimization

• >Async Git Commands: Convert sync commands to async with spawn_blocking to avoid UI blocking
• >TTL-Based Caching: 10-second cache for worktrees and branches lists with force bypass option
• >Git Hooks Throttling: 500ms throttle and deduplication to prevent burst requests
• >PTY Optimization: Avoid Windows DLL search path hang when conpty.dll is absent
• >Lightweight Branch Loading: New list_worktree_branches() for faster branch enumeration

File System Watcher

• >Project FS Watcher: Notify-based file system watcher with debouncing and filtering
• >Depth-Aware Listing: Configurable max_depth for file scanning (shallow for UI, deep for search)
• >FS Watch Registry: Track active watchers with auto-cleanup on page unload
• >Smart Filtering: Exclude high-churn directories (.git, node_modules, etc.)
• >Reference Counting: Multiple watchers on same path share single subscription

Explorer Improvements

• >Optimized Loading: Shallow scan (depth=2) on initial load, deep scan (depth=10) for search
• >Non-Blocking Updates: Use startTransition for smooth tree updates
• >Request Deduplication: Prevent race conditions during rapid navigation
• >Context Menus: Enhanced FileTreeSection with improved context menu actions
• >Idle Throttling: requestIdleCallback-based throttling for silent refresh

Database Layer

• >Rusqlite DB Layer: Lightweight cached connections with WAL mode and connection pooling
• >Direct SQL Access: sql_execute, sql_query, sql_batch commands for flexible queries
• >Chat Persistence V2: Queued writes with batched async saves via chatPersistenceQueue
• >Runtime FS Scope: expand_fs_scope command for dynamic permission expansion

Terminal Enhancements

• >Text Selection: Select and copy text from terminal output
• >Search Toolbar: Find text in terminal with navigation controls
• >Pre-Signaled PTY: begin_create_pty_with_token for optimized PTY initialization
• >PTY Init Module: Refactored initialization flow for better reliability

UI/UX Refinements

• >Collapsible TodoWrite: Collapsed by default with priority-based summary display
• >TabsWithScrollbar: Horizontal scrolling for overflow tab lists
• >Unified Settings: Consistent Card-based layouts across all settings tabs
• >CSS Variable Theming: Migrated shadcn components to CSS variable approach

Build & Infrastructure

• >Monaco CSP Compliance: Local Monaco assets plugin for Tauri CSP requirements
• >Startup Diagnostics: Performance timing logs and DEV mode profiler
• >Expanded FS Permissions: Broader Tauri FS scope for user directories
• >Tauri Devtools: Enable devtools feature for debugging

Better AI Context

• >Select for Context: Select any files/symbols/contexts to provide context for AI prompts
• >Use github issue: Use GitHub issues as context for AI prompts
• >Filter Files Buffer: Filter files and then show them in a buffer view to select any context

Worktree Database Sharing

• >DB Identity: All worktrees of the same repository now share a single database
• >Git Main Root Detection: New get_git_main_root resolves to main repo for worktrees
• >Scoped Persistence: Tab deletion is scoped to current worktree to prevent cross-deletion
• >Path Normalization: Consistent path matching across Windows/Unix platforms

Workflow Engine

• >Context Variable Handling: Workflows pause when template variables are missing
• >Context Required Events: UI collects missing inputs before workflow resumes
• >Working Mode Selection: Choose local or worktree isolation per workflow session
• >Auto Worktree Creation: Automatically create worktree when starting in worktree mode
• >Context Parsing: Parse user input as JSON or key:value format for context patches
• >WAL Persistence: Write-ahead logging for workflow session crash recovery

Inline Permissions ACP

• >No More Modals: Permission requests now appear inline as tool call cards
• >AskUserQuestion Redesign: Paginated questionnaire UI with multi-select support
• >Progress Indicators: Visual progress for multi-question surveys
• >Answer Forwarding: Questionnaire responses route through dedicated API

Agent Integration

• >ACP Based Agent Design: Based on ACP from Zed
• >Multi-Session Support: Run multiple concurrent agent sessions with isolated state
• >Codex SDK: Full OpenAI Codex CLI integration with JSON Lines transport
• >Model Switching: Runtime model switching via set_model command
• >Enhanced Permissions: Tool name, arguments, and suggestions in permission requests

Settings & Configuration

• >MCP Tab: New settings panel for MCP server management
• >Model Definitions: Centralized model configuration with defaults
• >Agent Options Builder: Utility for building agent options from MCP config

UI/UX Improvements

• >Project Name in TitleBar: Centered project name display via useTitleBar hook
• >Explorer Layout: Refined tabs styling with borders and rounded corners
• >File Tree Overflow: Max-width constraints prevent horizontal overflow
• >File Search Placeholder: Helpful message when no project is open

Mobile Support

• >Companion App: Control agents from iOS/Android via QR code pairing
• >Remote Approval: Authorize file modifications and actions on the go
• >Real-time Sync: Seamless chat history synchronization across devices
• >Touch Optimized: Keyboard-optional interface for mobile control

Streaming Architecture

• >StepProgressPayload: Granular real-time agent execution feedback
• >Text Delta Streaming: Progressive content display during generation
• >Tool Call Status: Live tracking with running/completed/failed states
• >Workflow Chat UI: Enhanced streaming display for agent interactions

Chat Improvements

• >Contextless Messaging: Send messages without requiring existing tabs
• >Auto Tab Creation: Automatically create new tab when sending with no tabs open
• >Session Type Preservation: Workflow sessions maintain their type on restore
• >Orphan Tab Filtering: Clean up tabs referencing non-existent sessions

Agent Client Protocol (ACP)

• >Runtime & Permissions: Full ACP module with granular tool authorization
• >SDK Adapters: Unified interface for Claude Code and Codex agents
• >Agent Discovery: MCP server integration for tool discovery
• >ACP Mode: Dedicated UI mode for agent management

Workflow System

• >Visual Editor: ReactFlow-based workflow builder with drag-and-drop
• >YAML Sync: Bidirectional synchronization between visual and code views
• >Node Types: Trigger, Agent, Condition, Parallel, and Output nodes
• >Persistence: Auto-save workflows to localStorage with draft recovery
• >Streaming Executor: Real-time workflow step execution with progress updates

Chat & Editor

• >Specialized Tool Cards: PlanMode, AgentRun, TodoWrite, EditPreview cards
• >Nested Agent Support: Parent/child relationships for agent runs
• >Tiptap Editor: Rich text with mentions (@files, #symbols) and slash commands
• >History Panel: Browse and restore previous conversations
• >Working Modes: Local vs worktree isolation for AI modifications
• >Terminal References: Include terminal output in chat context

Worktree Isolation

• >Dedicated Store: Centralized worktree state management
• >Merge Support: Squash and merge strategies with conflict detection
• >Auto Cleanup: Remove worktree and branch after successful merge
• >Branch Protection: Main branch stays clean until explicit merge

UI/UX

• >Command Palette: Fuzzy search with customizable keyboard shortcuts
• >Window Close Orchestration: Safe shutdown with unsaved changes protection
• >Preview Panel: Multi-framework inspector (React, Vue, Svelte)
• >Layout Controls: Flexible panel management and DevTools enhancements
• >Auto-Update System: OTA updates with UI controls and notifications

Performance

• >Transaction Batching: Atomic DB operations for chat persistence
• >PTY Throttling: 125ms debounce to prevent IPC storms
• >ScrollArea Ref: Programmatic scroll control for chat panels
• >Context Menu Fix: Resolved Radix UI repositioning bug