🐛 Bug Fixes

• Modifier Keys for Special Keys Outside Tmux: Shift/Ctrl/Alt now work correctly with arrow keys, Home, End, PageUp/Down, Insert, Delete, and F1-F12 outside tmux.
• URL Underline Positioning: Fixed underlines starting at wrong position in split panes, drifting on scroll, and lagging in alt-screen editors (joe, vim).
• Split Pane Scrollbar: Scrollbar now shows for all panes with scrollback (not just focused), with stable column counts across focus changes.
• HiDPI Scrollbar: Fixed scrollbar positioning and width scaling on Retina/HiDPI displays.

⚡ Performance

• Non-blocking URL Detection: Eliminated blocking locks in URL detection during render, fixing FPS drops with tmux 6+ panes.

⚡ Performance

• Non-blocking Render Loop: Replaced blocking mutex locks in the cell generation path with try_lock() + cache fallback, fixing severe FPS drops (60→5) with animated shaders when tmux has many active panes.
• Focused Pane Cell Caching: Focused pane cells are cached per frame, eliminating a redundant cell generation + lock acquisition.
• Efficient GPU Buffer Uploads: Pane instance buffers now upload only the populated slice instead of the full window-grid-sized array.

🐛 Bug Fixes

• macOS/Linux Shift+Letter in modifyOtherKeys Mode 2: Shift+letter combinations no longer produce lowercase output in crossterm-based apps (e.g. Claude Code). Shift-only alphabetic keys are now exempted from mode-2 encoding, matching the existing mode-1 exemption.
• Text Selection Highlight Follows Scroll: The selection highlight no longer freezes at its original viewport position after scrolling. Selection now records the scroll offset at capture time and the renderer adjusts accordingly — applies to normal, line, and rectangular selection modes in all layouts.

🔒 Security

• ACP Sensitive-Path Blocklist Extended: ~/.aws/, ~/.docker/, ~/.netrc, ~/.config/gh/, and ~/.config/gcloud/ now blocked by is_sensitive_path(), closing a credential-exfiltration vector for AI agents with auto_approve enabled.
• NotebookEdit Reclassified as Write: Previously auto-approved as read-only; now requires user approval, preventing silent Jupyter notebook modification.
• Session Logger Credential Redaction: Added GITHUB_TOKEN=, HEROKU_API_KEY=, npm_token=, pypi_token=, gitlab_token=, circleci_token=, and Bearer <token> patterns to the redaction list.
• $SHELL Allowlist Validation: resolve_shell_path() now validates the shell basename against a known-shells allowlist before use.

🐛 Bug Fixes

• Windows Modifier Keys After Focus Loss: Shift/Ctrl/Alt no longer become permanently broken after a notification or popup briefly steals focus. InputHandler now synthesizes modifier state directly from physical key events as a fallback.
• Tmux Text Selection: Highlight no longer persists and clipboard is now populated correctly when a press→drag→release sequence spans a lock-miss on the PTY reader.

🏗 Architecture

• FontRenderingConfig Extracted: font_antialias, font_hinting, font_thin_strokes, and minimum_contrast grouped under font_rendering sub-struct (backward-compatible YAML).
• WindowConfig Extracted: Window appearance fields (window_opacity, blur_enabled, blur_radius, etc.) grouped under window sub-struct (backward-compatible YAML).
• Render Loop Deduplicated: resolve_glyph_with_fallback() extracted as a shared method; pane_render/mod.rs reduced from 1,062 → 792 lines.

🐛 Bug Fixes

• Tab Focus-Click: Clicking a tab while the app is unfocused now reliably selects that tab — egui hit-test misses are handled by a direct rect check with pending-switch fallback.
• Cmd+Shift Font-Size Keys: Cmd+Shift+= (+) and Cmd+Shift+- (_) no longer leak to the terminal when adjusting font size.
• Ctrl+L / Ctrl+Shift+K in Split Panes: Clear screen and clear scrollback now target the focused pane instead of always the root pane.
• --shader CLI Override: The --shader flag and --screenshot mode now correctly override the configured shader even after create_window() reloads config from disk.

🐛 Bug Fixes

• URL Hover Cursor Fix: Moving from a URL link into the tab bar or profile drawer no longer leaves a stuck pointer cursor.
• Split-Pane Paste Routing: Keyboard and middle-click paste now targets the focused pane instead of always using the primary pane.
• Split-Pane URL Detection: URL underlines no longer persist or appear at wrong positions when switching between split panes.
• Middle-Click Focus: Middle-clicking a non-focused split pane now switches keyboard focus before dispatching the paste.
• macOS Activation Click (acceptsFirstMouse): Clicking a tab while the app is in the background now selects that tab on the first click.

✨ New Features

• Duplicate Tab Keybinding: duplicate_tab is now a named keybinding action (default: Cmd+Shift+N / Ctrl+Shift+N). Assign any hotkey via Settings → Keyboard → Actions.
• New Tab Position: New config option new_tab_position — end (default) or after_active to insert new tabs immediately to the right of the active tab. Configurable in Settings → Window → Tab Bar.
• Per-Tab Tmux Auto-Connect: Profiles can automatically connect to a named tmux session on open. Arrangements capture and restore the session name. Configurable via the Tmux Auto-Connect section in the profile editor (control_mode or normal mode).
• Remote Tab Title Format: Two new config fields control SSH tab display — remote_tab_title_format (user_at_host / host / host_and_cwd) and remote_tab_title_osc_priority. Exposed in Settings → Window → Tab Bar.
• Workflow Action Types: Three new custom action types for multi-step automation:
  • sequence — runs a list of actions in order with per-step delay_ms and on_failure policy (abort / stop / continue)
  • condition — evaluates a check (exit_code, output_contains, env_var, dir_matches, git_branch) and branches on the result
  • repeat — runs an action up to N times with optional delay; supports stop_on_success / stop_on_failure
• capture_output for Shell Commands: Set capture_output: true on a shell_command action to capture stdout+stderr (up to 64 KB) for use by subsequent condition checks.
• Clone Button for Custom Actions: Each action row in Settings → Actions now has a Clone button that duplicates the action with a fresh ID, clears the keybinding and prefix char.

🐛 Bug Fixes

• Tab Click Selection Stuck: Releasing the mouse in the tab bar no longer leaves a persistent text-selection highlight on the terminal pane.
• Local Tab Titles Showing Hostname Only: Local tabs no longer incorrectly show the remote-host title format when shell integration is active.
• Braille Spinner Characters in Tab Bar: Claude Code's thinking indicator (⠋⠙⠹…) and other Braille block characters now render correctly via a platform system-font fallback.
• Text Selection in Native Split Panes: Clicking within the already-focused pane now correctly anchors a selection.
• Selection Highlight Row Alignment in Split Panes: Fixed up-to-half-cell row offset during drag-selection caused by missing centering offset in pixel-to-cell mapping.
• Split-Pane Divider Highlight Stuck: Releasing the mouse outside the terminal (e.g. in tab bar or context menu) no longer freezes the divider hover highlight.
• Shell Integration $HOME Path: The entries written to .bashrc / .zshrc / config.fish now use $HOME/ instead of a literal home path, making them portable across user renames.
• Profile Drawer Behind Status Bar: The profile drawer side panel now stops above the custom status bar instead of extending behind it.
• Scrollback Flash in Tmux on Lock Contention: Mouse scroll events during lock contention no longer briefly scroll par-term's own scrollback instead of forwarding to tmux. Added a per-pane cell cache for lock-miss fallback.

🔒 Security & Safety

• i_accept_the_risk Guard: Triggers with prompt_before_run: false now require an explicit i_accept_the_risk: true field; execution blocked with an audit warning if absent
• Shader Installer Requires Checksum: Installing shaders without a .sha256 asset is now a hard error instead of a warning
• Prettifier External Commands Default-Deny: ExternalCommandRenderer refuses execution when allowed_commands is empty (the default)
• Clipboard Paste Control-Char Warning: New warn_paste_control_chars config option (default true) warns when clipboard content contains VT escape sequences
• O_NOFOLLOW for Debug Log: Debug log open path on Unix uses O_NOFOLLOW to close a TOCTOU symlink-race window
• allow_all_env_vars Startup Warning: Prominent warning emitted at startup when allow_all_env_vars: true is detected

✨ New Features

• split_pane Custom Action: Split the active pane and optionally run a command — shell mode (text to shell) or direct mode (PTY process, closes on exit)
• new_tab Custom Action: Open a new tab and optionally send a command to it; exposed in settings UI as a dedicated New Tab action type
• Custom-Action Prefix Mode: tmux-style two-stroke bindings — configure a global custom_action_prefix_key and assign a prefix_char per action
• split_percent for split_pane Actions: Control the split ratio (10–90, default 66) for both custom actions and trigger split_pane; displayed in settings UI as [Split-vert-66]
• split_pane Trigger Action: Triggers can now open a new pane when a regex matches terminal output
• prompt_before_run Confirmation Dialog: Dangerous trigger actions show an interactive modal (Allow Once / Always Allow / Deny) before executing

🐛 Bug Fixes

• "Skip This Version" Now Persists: skipped_version is now properly written to disk when clicking "Skip This Version" in the update dialog
• URL/Path Trailing Punctuation Stripped: ., !, ? at end of detected URLs/paths are no longer included in highlights or click targets
• Prefix Key Capture: Bound prefix chars and Esc no longer leak to the terminal while prefix mode is armed
• PageUp/PageDown Forwarded: Now forwarded to terminal apps as \x1b[5~/\x1b[6~; scrollback requires Shift+PageUp/Shift+PageDown
• Middle-Click tmux Paste: Now focuses the clicked pane before pasting, matching iTerm2 behaviour
• File Drops Target Pane Under Cursor: In split-pane and tmux modes, dropped files go to the pane at the drop position
• Text Selection in Native Split Panes: Clicking within the already-focused pane now correctly anchors a selection; previously the pane-focus handler always returned early for any multi-pane click, blocking selection entirely
• Selection Highlight Row Alignment in Split Panes: Fixed up-to-half-cell row misalignment during drag-selection caused by the renderer's centering offset (center_offset_y) not being subtracted in pixel-to-cell coordinate mapping

🏗️ Architecture & Quality

• 36 Audit Findings Resolved: Security hardening, doc coverage, dead code removal, render path cleanup
• Sub-Crate READMEs: 11 previously undocumented sub-crates now have individual README files
• dev-release Profile Optimized: ~1-2s incremental rebuilds at ~90-95% of full release performance
• ATLAS_SIZE Constant: 16 scattered 2048.0 magic literals replaced with a named constant
• 151 New Docstrings: par-term-config/src/defaults/ fully documented

🔒 Security & Safety

• ACP Path Hardening: file:// URLs blocked in dynamic profile fetcher; sensitive paths (~/.ssh/, ~/.gnupg/, /etc/) blocked in ACP file tools; $SHELL validated as absolute path to known binary
• Shader Integrity Checks: SHA256 checksum verified on shader downloads; 50 MB response body size limit enforced
• macOS API Guards: Private API calls (CGSSetWindowBackgroundBlurRadius, SkyLight SLS) now gated behind OS version check (≥ 13)
• Permission Hardening: Session data files written with 0o600; session log directories set to 0o700; config file persistence enforces 0o600
• ACP write-class enforcement: auto_approve mode always runs is_safe_write_path before approving write-class tool calls

✨ New Features

• Icon Picker Expansion: 60+ new icons across six new categories — TypeScript/Go/C/C++/Angular/Vue/Svelte/HTML5/CSS3/Haskell/Scala, OS platform icons, expanded Git & VCS, Weather & Nature, Fun & Seasonal
• Workspace Dependencies: Root Cargo.toml now has a [workspace.dependencies] table centralizing 38 shared dependency versions across all 15 crates
• Sub-Crate READMEs: par-term-config, par-term-ssh, and par-term-mcp now have individual README files
• cargo install par-term: Installation instructions added to README and Getting Started guide
• deny.toml: cargo-deny license/vulnerability/ban auditing with CI integration

🐛 Bug Fixes

• tmux Mouse Highlight: Selection no longer gets stuck spanning all panes when mouse tracking (e.g. tmux) consumes a press — local selection state is now cleared immediately
• tmux Drag Dead Zone: Spurious second mouse-press from the image-guard code is now suppressed when mouse tracking is already active, preventing mid-drag word-boundary snapping
• Middle-Click Paste Priority: Middle-click paste takes priority over mouse tracking and alt-screen mode, matching iTerm2 behaviour
• Clipboard Wipe on Pane Switch: Trackpad micro-movements are now suppressed within the same 8 px dead zone as local text selection — clicking between tmux panes no longer wipes the clipboard
• Powerline Dark Fringe: Eliminated the dark gap between powerline separator glyphs and adjacent colored segments in background-image mode
• Custom Shader Regression: Fixed regression where custom shader background was hidden by opaque default-bg cell quads; new fill_default_bg_cells flag controls default-bg rendering independently of skip_solid_background
• Icon Picker Scroll Overlap: Added right padding inside the icon picker scroll area to prevent scrollbar from overlapping icons
• Divider Drag Hit Width: Default split pane divider drag hit width reduced from 8 px to 5 px for more precise click targeting

🏗️ Architecture & Quality

• 57 Audit Findings Resolved: Security hardening, named types replacing #[allow(clippy::type_complexity)], shared get_or_rasterize_glyph() helper, scratch buffer reuse, dead code removal
• SearchHighlightParams Struct: Replaced a 9-parameter function signature with a named struct
• fill_visible_separator_marks() API: New scratch-buffer API for separator mark computation
• Dark Tab Colors: Dark-theme tab color presets dimmed by 25% for better visual comfort
• Updated Core Library: par-term-emu-core-rust updated to v0.40.0

🔒 Security & Safety

• Paste Control Character Sanitization: Control characters are now stripped from clipboard paste to prevent injection via crafted clipboard content
• MCP IPC File Permissions: MCP IPC socket files created with restrictive permissions to prevent unauthorized access
• Session Logger Password Redaction: Passwords redacted from session log output
• Config Variable Substitution Allowlist: Config variable substitution restricted to explicit allowlist to prevent injection
• RunCommand Trigger Restriction: RunCommand actions can no longer be triggered from terminal output — user key presses only
• Graceful Shutdown: Replaced abrupt process::exit() with proper graceful shutdown

🐛 Bug Fixes

• Box-Drawing Line Thickness (tmux Borders): Fixed tmux pane borders rendering inconsistently — pixel rectangles snapped to integer boundaries for consistent line thickness
• Prettifier Line Mapping: Fixed index drift in cell substitution when rendered output differs from source line count
• Prettifier Cell Dimensions: GPU cell metrics now synced into prettifier pipeline — inline graphics (Mermaid, etc.) sized correctly
• Prettifier Small Block Detection: Removed block-size guard that prevented small blocks from rendering
• Prettifier Claude Code Integration: Viewport hash used to clear stale Claude Code blocks; CC segmentation and throttle restored in split module
• Split-Pane Unsafe Cell Pointer: Eliminated unsafe cell pointer leak in split-pane render path

✨ New Features

• Content Prettifier: Detects structured content in terminal output (Markdown, JSON, YAML, TOML, XML, CSV, diffs, logs, diagrams, SQL results, stack traces) and renders with syntax highlighting, table formatting, and color-coded diffs — pluggable architecture with custom renderer support, per-profile overrides, and Settings UI tab
• Font Hinting Enabled by Default: Improved text sharpness at common display sizes (toggle in Settings → Appearance)

🐛 Bug Fixes

• Inline Graphics in Split Pane Mode: Sixel/iTerm2/Kitty graphics now render correctly in split-pane layouts
• Scrollback in Split Pane Mode: Mouse-wheel scroll, Page Up/Down, and keyboard marks navigation now work in split panes
• Scrollbar in Split Pane Mode: Scrollbar now appears inside the focused pane's bounds
• clear Removes Inline Graphics: ED 2/ED 3 erase-display sequences now clear all inline graphics
• Window Arrangement DPI Fix: Arrangement restore now works correctly across mixed-DPI multi-monitor setups
• Character Rendering Artifacts: Fixed thin bright lines at cell edges from bilinear sampling bleed
• Symbol Rendering: Fixed symbols from emoji fonts (dingbats, misc symbols) rendering incorrectly
• Text Selection in Mouse-Tracking Apps: Shift+click/drag now bypasses app mouse tracking for local selection
• tmux Pane Click Fix: Clicks no longer blocked by clipboard image guard
• Trackpad Jitter Selection: Increased drag dead-zone to suppress accidental micro-selections
• Tab Emoji Rendering: Sanitized emoji/ZWJ sequences in tab labels to avoid tofu
• Settings Search Keywords: Fixed and expanded search keywords across all settings tabs
• Startup Error Message: par-term now prints clear errors on startup failure (e.g., missing display server)

• Agent Screenshot Tool: terminal_screenshot MCP tool for visual terminal capture by ACP agents
• Code Block Rendering in Chat: Agent messages with fenced code blocks render with dark background, border, language label, and monospace font
• Cancel Queued Messages / Streaming: Cancel buttons for queued and in-progress messages
• Multi-line Chat Input: Enter sends, Shift+Enter inserts newline, grows up to 6 rows
• Auto-Approval Chat Notifications: Auto-approved tool calls show in chat history
• Best-Effort Context Restore: Reconnecting preserves prior chat context
• Glass Sphere Bounce Shader: New background shader
• Fixed: Input/shader lag, scrollbar repositioning, new-tab button clipping, assistant panel overlap, clipboard image loss, tab bar borders

• Nerd Font Icons for Profile Picker: Replaced emoji presets with ~120 curated Nerd Font icons across 10 categories with descriptive tooltips
• Tab Icon via Context Menu: Right-click any tab to pick a custom icon from the Nerd Font grid — persists across sessions, layouts, and tab duplication
• Tab Title Mode: New tab_title_mode config option (auto / osc_only) controls automatic tab title updates
• Rename Tab: Right-click any tab to set a custom static name — enter blank to revert to automatic behavior
• Major Idle CPU Reduction: Reduced idle CPU from ~103% to ~18-25% via conditional dirty tracking, fast render path, adaptive polling backoff
• Fixed: Layout restore tab properties, input lag, scrollbar overlap, geometric shapes, clipboard loss, settings revert, tab bar borders

• Status Bar Update Widget: New UpdateAvailable widget with clickable update dialog
• Rain Glass Shader: New rain-glass.glsl background shader
• Inactive Tab Outline-Only Mode: New tab_inactive_outline_only option
• File Transfer Progress Overlay: Upload/download progress bars in bottom-right overlay
• Inline Image Display Fix: Fixed images >750 KB not rendering
• Upload Over SSH Fix: Fixed uploads hanging indefinitely
• Default window_padding → 0.0, font_hinting → false, tab_bar_mode → always

✨ New Features

• Configurable Link Highlight Color: Link highlight color for detected URLs and file paths is now configurable via link_highlight_color setting
• Link Underline Rendering: Detected URLs and file paths now render with visible underlines in the GPU text pipeline
• Stipple Underline Style: Added link_underline_style setting with Solid and Stipple options

🐛 Bug Fixes

• Fast Window Shutdown: Fixed slow app close (beachball on macOS) that scaled with number of open tabs
• Settings Sidebar Icon: Fixed Input tab (⌨️) showing an empty box
• Crate Package Size: Reduced package from 24.7MiB to 3.9MiB

✨ New Features

• Quick Settings Shader Toggles: BG Shader and Cursor Shader toggle checkboxes in the settings UI quick settings strip
• Focus Event Forwarding: Forward CSI focus-in/out sequences to PTYs with DECSET 1004 focus tracking enabled

🐛 Bug Fixes

• Dingbat/Symbol Monochrome Rendering: Fixed dingbat characters rendering as colorful emoji instead of monochrome symbols
• Focus Click Clipboard Loss: Suppress first mouse click that focuses the window to prevent clipboard clearing
• Image Paste in Claude Code: Fixed Cmd+V not forwarding to terminal when clipboard contains an image but no text
• Settings Sidebar Icons: Fixed empty box rendering for several tab icons
• Shell Detection: Improved ShellType::detect() with multi-strategy fallback
• Settings Version Display: Fixed settings UI displaying subcrate version instead of app version
• Shell Integration Install/Uninstall: Fixed Install and Uninstall buttons not working

🏗️ Architecture

• Workspace Crate Extraction: Extracted 8 modules into dedicated workspace subcrates for maintainability

🔧 Bug Fixes & Dependency Updates

• macOS Self-Update: Auto-updater now removes macOS quarantine attributes (xattr -cr) from the downloaded .app bundle, preventing Gatekeeper from blocking the updated app on first launch
• Dependency Updates: Updated clap, libc, uuid, arboard, regex, zip, mdns-sd, ureq, and 27 transitive dependencies to latest versions

🤖 Assistant Panel (AI Integration)

DevTools-style right-side panel for terminal state inspection and ACP agent integration.

• Toggle with Cmd+I (macOS) / Ctrl+Shift+I (other) or keybinding action
• 4 view modes (Cards, Timeline, Tree, List+Detail) for browsing command history
• ACP agent chat: connect to Claude Code and other ACP-compatible agents via JSON-RPC 2.0 over stdio
• 8 bundled agent configs: Claude Code, Amp, Augment, GitHub Copilot, Docker, Gemini CLI, OpenAI, OpenHands
• Agent command suggestions with Run (execute + notify) and Paste actions
• Auto-context feeding: sends command results to connected agent on completion
• Yolo mode: auto-approve all agent permission requests
• Resizable panel with drag handle; terminal reflows columns when panel opens/closes/resizes

🎨 Shader Assistant for ACP Agents

Context-triggered shader expertise for ACP agents.

• Auto-detects shader-related queries and active shader state
• Injects full shader reference into agent prompts (current state, available shaders, uniforms, GLSL template)
• Config file watcher for live-reloading agent-applied shader changes

📂 Workspace Crate Extraction

Major refactoring into modular workspace crates for maintainability.

• par-term-fonts: Font management and text shaping
• par-term-terminal: Terminal manager, scrollback, styled content
• par-term-render: GPU rendering engine, shaders, cell renderer
• par-term-settings-ui: Complete settings UI (28 tabs at the time of extraction; later consolidated to 14 tabs in subsequent releases, sidebar, section helpers)
• All types re-exported from main crate for backward compatibility

📁 File Transfer UI

Native file dialogs and progress overlay for iTerm2 OSC 1337 file transfers.

• Native save dialog for downloads, file picker for uploads
• Real-time egui progress overlay with progress bars
• Desktop notifications for transfer lifecycle events
• Shell integration utilities: pt-dl, pt-ul, pt-imgcat for remote file operations

🐍 Scripting Manager

Python scripts that react to terminal events via the observer API.

• 12 event types (bell, cwd_changed, command_complete, etc.) and 9 command types
• Per-tab script lifecycle with auto-start and restart policies
• JSON protocol over stdin/stdout for bidirectional communication
• Markdown panels: scripts can register custom UI panels in Settings

🖼️ Per-Pane Background Images

Individual background images for each split pane with GPU texture caching.

• Per-pane image path, display mode (fit/fill/stretch/tile/center), and opacity
• Settings UI with pane index selector, file picker, mode dropdown, opacity slider

🌐 Dynamic Profiles from Remote URLs

Load team-shared profile definitions from remote URLs.

• Background auto-refresh with configurable timer and local cache
• Conflict resolution: Local Wins or Remote Wins
• Visual [dynamic] indicators; dynamic profiles are read-only

🔧 Other Changes

• Duplicate Tab: Right-click context menu option to duplicate any tab with same CWD and color
• Auto Dark Mode: Auto-switch terminal theme based on system light/dark appearance
• Automatic Tab Style: Tab bar style follows system theme with configurable light/dark mapping
• macOS Target Space: Open windows in a specific macOS Space (virtual desktop)
• Configurable Link Handler: Custom command for opening URLs instead of system default browser
• Fast Window Shutdown: Closing par-term is now visually instant instead of 8+ seconds
• Shift+Tab Fix: Now correctly sends CSI Z to terminal applications

🌐 SSH Host Management

Comprehensive SSH host profiles, quick connect, and auto-discovery.

• SSH Quick Connect dialog (Cmd+Shift+S) with search, keyboard navigation, grouped by source
• SSH config parser (~/.ssh/config), known hosts parser, shell history scanner
• mDNS/Bonjour SSH host discovery via _ssh._tcp.local. (opt-in)
• SSH-specific profile fields: host, user, port, identity file, extra args
• Automatic profile switching on SSH connection with auto-revert on disconnect

📊 Status Bar

Configurable status bar with widget system and system monitoring.

• 10 built-in widgets: clock, username@hostname, current directory, git branch, CPU/memory usage, network status, bell indicator, current command, custom text
• Widget configurator in Settings UI with drag-and-drop reordering
• Auto-hide on fullscreen and/or mouse inactivity

🔧 Other Changes

• Profile Selection on New Tab: Split +/▾ button on tab bar for quick profile launch
• Shell Selection Per Profile: Configure specific shells per profile with platform-aware detection
• Navigate to Settings from Application Menu: Platform-aware settings access
• Install Shell Integration on Remote Host: Shell menu option with confirmation dialog

📂 Directory-Based Profile Switching

Automatically switch profiles based on current working directory.

• New directory_patterns field on profiles (glob patterns like /Users/*/projects/work-*)
• CWD changes detected via OSC 7 trigger profile matching
• Priority: explicit user selection > hostname match > directory match > default
• Settings UI for editing directory patterns per profile

🎨 Tab Style Variants

Cosmetic tab bar presets with 5 built-in styles.

• Dark (default), Light, Compact, Minimal, and High Contrast presets
• Each preset applies coordinated color/size/spacing adjustments
• Config: tab_style: dark|light|compact|minimal|high_contrast

🔊 Alert Sounds

Configurable sound effects for terminal events.

• Per-event sound configuration: Bell, Command Complete, New Tab, Tab Close
• Each event supports: enable/disable, volume, frequency, duration, custom sound file
• Custom sound files: WAV/OGG/FLAC format with ~ home directory expansion
• UI in Settings > Notifications > Alert Sounds

🔍 Fuzzy Command History Search

Searchable overlay for browsing and selecting from command history.

• Fuzzy matching with ranked results via Skim algorithm
• Match highlighting, exit code indicators, and relative timestamps
• Keyboard navigation: Arrow Up/Down, Enter to insert, Esc to close
• History persisted across sessions; keybinding: Cmd+R (macOS), Ctrl+Alt+R (Linux/Windows)

↩️ Session Undo — Reopen Closed Tabs

Recover accidentally closed tabs.

• Reopen with Cmd+Z (macOS) or Ctrl+Shift+Z (Linux/Windows)
• Toast notification shows undo keybinding hint and countdown
• Optional shell session preservation for full session restore with scrollback intact
• Configurable timeout and queue depth

💾 Session Restore on Startup

Automatically save and restore session state.

• Saves open windows, tabs, pane layouts, and working directories on clean exit
• Restores full session on next launch including split pane trees with ratios
• Config: restore_session: true (default: false)

📍 Tab Bar Position

Configurable tab bar placement with three positions.

• Top (default), Bottom, or Left (vertical sidebar)
• Configurable sidebar width for Left position (default 160px, range 100–300)
• All positions support tab bar visibility modes and live switching via Settings UI

📥 Import/Export Preferences

Import and export terminal configuration.

• Export current config to a YAML file via native file dialog
• Import from local file or URL with replace or merge modes
• Merge mode only overrides values that differ from defaults

🔧 Other Changes

• Profile Emoji Picker: Curated grid of ~70 terminal-relevant emojis in 9 categories for profile icons
• Full Profile Auto-Switch Application: Directory, hostname, and tmux session switching now apply all visual settings (icon, title, badge, command)
• Profile Management in Settings: Profile create/edit/delete/reorder UI moved inline to Settings > Profiles tab
• Settings Quick Search: Added missing search keywords across all settings tabs
• HiDPI/DPI Scaling Fix: All pixel-dimension config values now correctly scale on HiDPI displays
• Text Shaper LRU Cache: Upgraded from FIFO to proper LRU eviction for better cache hit rates
• Default Update Check: Changed from weekly to daily for faster update discovery

🔄 Self-Update

par-term can now update itself in-place — no package manager needed.

• CLI: par-term self-update with --yes flag for non-interactive use
• Settings UI: "Check Now" and "Install Update" buttons in Advanced > Updates
• Detects installation method (Homebrew, cargo, .app bundle, standalone binary) and shows appropriate instructions

─── Command Separator Lines

Horizontal separator lines between shell commands in the terminal grid.

• Renders thin lines at prompt boundaries using shell integration (OSC 133) marks
• Exit-code coloring: green for success, red for failure, gray for unknown
• Configurable thickness, opacity, and custom fixed color

🔀 Drag-and-Drop Tab Reordering

Reorder tabs by dragging them in the tab bar with ghost tab preview and insertion indicators.

📐 Window Arrangements

Save and restore window layouts (iTerm2 parity) with monitor-aware positioning and auto-restore on startup.

🔧 Other Changes

• Variable Substitution in Config (#102): Use ${VAR} and ${VAR:-default} in config.yaml values
• Shell Integration Event Queuing: OSC 133 markers now queue with cursor positions
• Remember Settings Section States (#105): Collapsible section states persist across sessions

📋 Vi-Style Copy Mode

Keyboard-driven text selection and navigation (iTerm2 parity).

• Full vi motions: h/j/k/l, w/b/e, 0/$, gg/G, count prefixes, half/full page scrolling
• Visual selection: Character (v), Line (V), and Block (Ctrl+V) modes with yank to clipboard
• Search: /pattern forward, ?pattern backward, n/N repeat (case-insensitive, wrapping)
• Marks: m{a-z} set, '{a-z} jump — persistent per-tab bookmarks through scrollback
• Status bar: Mode indicator (COPY/VISUAL/V-LINE/V-BLOCK/SEARCH) and cursor position
• Settings: Enable/disable, auto-exit on yank, status bar visibility (Settings > Input > Copy Mode)

📝 Snippets & Actions Completion

• Custom Variables UI: Collapsible per-snippet variable editor (name/value grid)
• Key Sequence Simulation: KeySequence actions send terminal byte sequences (Ctrl combos, arrow keys, F-keys)
• Import/Export: Export/import snippets as YAML with duplicate detection and keybinding conflict resolution

🔤 Unicode Normalization

Configurable normalization form (NFC/NFD/NFKC/NFKD/None) in Settings > Terminal > Unicode. Live-updates across all tabs.

🔧 Fixed

• Color emoji rendering (Apple Color Emoji now renders as colored bitmaps instead of monochrome outlines)
• Tmux pane resize via mouse drag (drag events now forwarded when mouse tracking enabled)
• Text baseline alignment (eliminated per-glyph rounding artifacts)
• File/URL link highlighting offset with multi-byte UTF-8 characters
• Absolute file path detection in link highlighting regex

📝 Snippets & Actions System

Text automation and custom actions (iTerm2 parity).

• Text Snippets: Save text blocks with variable substitution (\(variable) syntax), 10 built-in + 12 session variables
• Custom Actions: Shell commands, new-tab launchers, text insertion, pane splits, and keyboard shortcuts triggered via keybindings
• Settings UI: Two new tabs — Snippets (📝) and Actions (🚀) — with keybinding recording and conflict detection
• Auto-Execute: Optional checkbox to run commands immediately when keybinding is pressed

📊 Progress Bar Rendering

Overlay progress bars via OSC 9;4 and OSC 934 protocols.

• Configurable style (bar or bar-with-text), position, height, opacity, and per-state colors
• Named concurrent progress bars stack vertically
• New iProgress shader uniform for progress-reactive shader effects

📋 Paste Enhancements

• Paste Delay: Configurable delay between pasted lines (paste_delay_ms, 0-500ms)
• Newline Control: Three new Paste Special transforms — Single Line, Add Newlines, Remove Newlines

🖥️ Shell Integration Enhancements

• Command in Title: Window title shows [command_name] during execution
• Badge Variables: \(session.exit_code) and \(session.current_command)
• Remote Host: OSC 1337 RemoteHost syncs hostname and username to badge variables

🖼️ Image & Pane Improvements

• Image Scaling: Choose nearest or linear filtering for inline images
• Aspect Ratio Control: Toggle aspect ratio preservation for inline images
• Pane Titles: GPU-rendered title bars for split panes
• Divider Styles: Four visual styles — Solid, Double, Dashed, Shadow

⌨️ Cross-Platform Keybindings

Redesigned Linux/Windows defaults to avoid conflicts with terminal control codes (Ctrl+C, Ctrl+V, etc.). macOS unchanged.

🔧 Fixed

• Dingbat/symbol rendering as colored emoji instead of monochrome glyphs
• Pane focus indicator, background opacity, divider hover, and divider width settings (#88)
• Platform-specific keybinding labels in snippet rows

⚡ Triggers, Trigger Actions & Coprocesses

Full automation system for terminal output processing with regex triggers, 7 action types, coprocesses, and scrollbar marks.

♿ Minimum Contrast Enforcement

WCAG-based accessibility — auto-adjusts text color when contrast ratio is too low.

📂 Semantic History

Ctrl+click file paths in terminal output to open them in your editor.

🔧 Configurable Log Level

Runtime log level control via log_level config or --log-level CLI flag.

🏷️ Per-Profile Badge Configuration

Full badge customization per profile (iTerm2 parity). Profiles can now override badge color, opacity, font, position, and size constraints individually.

⚡ Performance: Maximize Throughput Mode

Manual toggle for prioritizing bulk output processing over immediate responsiveness. Toggle with Cmd+Shift+T (macOS) or Ctrl+Shift+T (other platforms).

🖥️ Reduce Flicker

iTerm2-style flicker reduction for smoother terminal updates. Delays redraws while cursor is hidden (DECTCEM off).

🎮 GPU Power Preference

Control which GPU is used for rendering on multi-GPU systems: none, low_power, or high_performance.

🔄 Tmux Profile Auto-Switching

Automatically apply profiles when connecting to tmux sessions via tmux_session_patterns glob patterns.

⌨️ Enhanced Keyboard Input

Modifier key remapping, physical key bindings, and modifyOtherKeys protocol support.

🛡️ Close Confirmation for Running Jobs

Confirmation dialog when closing tabs/panes with active processes.

🔧 Shell Exit Action

Configurable behavior when shell exits: close, keep, restart_immediately, restart_with_prompt, or restart_after_delay.

📋 Welcome Dialog Changelog Link

The welcome/onboarding popup now includes a "View Changelog" link for easy access to release notes.

📁 Configurable Startup Directory

Control where new terminal sessions start with three modes: home, previous, or custom.

🏷️ Badge System

iTerm2-style semi-transparent text overlays with 12 dynamic variables and full appearance customization.

📊 Scrollbar Mark Tooltips

Hover over scrollbar command markers to see command text, execution time, duration, and exit code.

🎨 Tab Bar Enhancements

• Tab stretch to fill bar width (tab_stretch_to_fill)
• HTML markup support in tab titles

🔌 Integrations Install System

Unified installation for optional par-term enhancements.

• Shell Integration: Scripts for bash/zsh/fish enabling prompt navigation, CWD tracking, and command status
  • Install via CLI: par-term install-shell-integration
  • Install via curl: curl -fsSL https://paulrobello.github.io/par-term/install-shell-integration.sh | bash
• Shader Bundle with Manifest: Tracks bundled vs user-created files using SHA256 hashes
• Welcome Dialog: First-run prompt offering to install both integrations
• Settings UI Tab: New "Integrations" tab (🔌) for managing installations

👤 Profile System

iTerm2-style profiles for saved terminal configurations.

• Profile Manager: Create, edit, delete, and reorder named profiles
• Profile Drawer: Collapsible right-side panel for quick profile access
• Profile Settings: Name, emoji icon, working directory, custom command, tab name override
• Persistence: Profiles saved to ~/.config/par-term/profiles.yaml

📹 Session Logging & Recording

Automatic session logging to record terminal output.

• Multiple Formats: Plain text, HTML (with colors), Asciicast (asciinema-compatible)
• Hotkey Toggle: Cmd/Ctrl+Shift+R to start/stop session recording on demand
• CLI Option: --log-session flag to enable logging at startup

🔳 tmux Integration Enhancements

• Native Status Bar: Session name, window list, and time display at terminal bottom
• Bidirectional Pane Resize: Resizing in par-term updates external tmux clients
• Auto-Close Exited Panes: Panes close when their shell process exits

🔍 Terminal Search

Search through scrollback buffer with Cmd/Ctrl+F.

• Match highlighting with navigation (Enter/Shift+Enter)
• Search options: case sensitive, regex mode, whole word
• Proper Unicode support for multi-byte characters

📋 Paste Special

Transform clipboard content before pasting with Cmd/Ctrl+Shift+V.

• 28 text transformations across shell escaping, case conversion, whitespace, and encoding
• Live preview with keyboard navigation
• Integration with clipboard history via Shift+Enter

⌨️ Option Key as Meta/Esc

Essential feature for emacs/vim users.

• Configure left and right Option/Alt key behavior independently
• Three modes: Normal (special characters), Meta (high bit), Esc (ESC prefix)

🖼️ Shader Gallery

• Browse the Gallery: See all shaders before installing
• Auto-Updated: Gallery automatically deploys when shaders are added or modified

⌨️ Configurable Keybindings

• Custom Bindings: Edit ~/.config/par-term/keybindings.yaml
• Modifier Support: Ctrl, Alt, Shift, Super in any combination

🖥️ CLI Enhancements

• --screenshot <path>: Capture terminal to image file
• --shader <name>: Override background shader on launch
• --exit-after <seconds>: Auto-exit after duration
• --command <cmd>: Run specific command instead of default shell

🪟 Standalone Settings Window

• F12 or Cmd+, (macOS) / Ctrl+, (Linux/Windows) to open
• Settings window stays visible when terminal gains focus

🎨 Per-Shader Configuration System

• Shader metadata in GLSL files, per-shader overrides, global fallback
• Shader hot reload with desktop notifications

🔤 Enhanced Unicode Rendering

• Grapheme clusters (flag emoji, ZWJ sequences, skin tones)
• Geometric box drawing and block elements

🗂️ Tab Bar Enhancements

• 11 color options, per-tab colors, equal-width layout

🔒 Window Transparency

• macOS blur, proper alpha handling, keep_text_opaque option

🎮 Shader System

• Cubemap support, iTimeKeyPress, 9 new shaders

🔋 Power Saving

• pause_shaders_on_blur, pause_refresh_on_blur, unfocused_fps

Multi-Tab Support

• Cmd/Ctrl+T new tab, Cmd/Ctrl+W close tab
• Cmd/Ctrl+Shift+[/] or Ctrl+Tab to switch tabs
• Cmd/Ctrl+1-9 direct tab access
• Tab bar with close buttons, activity indicators, bell icons

Multi-Window Support

• Cmd/Ctrl+N new window with independent PTY session
• Each window has its own tabs, scrollback, and state

Native Menu Bar

• Cross-platform menus via muda
• Full keyboard accelerators for all menu items

Custom Shader Enhancements

• Shadertoy-compatible iChannel1-4 texture support
• custom_shader_brightness for better text readability
• cursor_shader_hides_cursor for shader-controlled cursors

Ghostty-Compatible Cursor Shaders

• iCurrentCursor, iPreviousCursor, iCurrentCursorColor, iTimeCursorChange uniforms
• Built-in cursor shaders: sweep, warp, glow, blaze, trail, ripple, boom
• Geometric cursor rendering for all styles

Fixes

• Login shell initialization and environment loading

Power Efficiency

• Event-driven rendering with ControlFlow::Wait
• Smart redraws only when content changes

Stability

• Fixed dropped input during heavy rendering
• parking_lot mutex migration
• Graceful audio fallback