開發 動態

Framework Route Nodes (Code Graph)

• Route definitions across five web frameworks — Express, Fastify, Koa, FastAPI, Flask — are extracted as first-class code graph nodes, traceable from route to handler to middleware
• All common registration styles are recognized: app.get, router.route().get(), decorators, chained forms, and srv.get after const srv = express()
• Route detection is more robust and self-heals after reloads

Diff Impact Analysis

• A git diff maps straight onto the code graph and walks back to affected callers — know the blast radius before you send the review
• New onboarding graph output helps you get oriented in an unfamiliar codebase

Git Review Surface

• Visual diff review surface: three-pane layout with blame, hunk-level cross-file navigation, and smooth handling of large files
• Twin Focus: corresponding tokens highlight on both sides at once — renames line up at a glance
• Read-only merge / conflict review surface arrives
• Colors follow your theme, visually aligned with the editor
• Annotated tag messages show across git views
• Fixed rename diffs and ±N stats, including non-ASCII filenames
• Refresh now picks up git repos that weren't detected at startup

Dock Parking & Workspace Ergonomics

• Drag a terminal session into the dock to park it: no pane, no tab-strip slot, notifications still accrue, ready to pick back up anytime
• Drop zones are visualized during drag, and dropping anywhere on the sidebar parks the session
• Drop a folder onto Termdock to create a workspace — no manual setup
• Pasted-file temp paths now resolve against the terminal's own workspace — no more cross-workspace mix-ups

Performance

• Code indexing moved to a native Rust pipeline — noticeably faster on large projects
• Lower overhead under heavy terminal output, and reduced idle CPU usage

Agent Integration

• Agent sessions add a GitLab Duo CLI provider alongside Claude, Codex, and Gemini
• Remote input is more reliable for TUIs — the submit key is never missed; screenshots no longer hang
• Agents create background sessions by default — no more stealing the user's pane
• Remote control stays consistent after a window reload

Index Correctness

• Cross-file references no longer go stale after edits
• Fixed misplaced results for same-named methods across classes and phantom paths from re-exports
• Incremental indexing now works as intended instead of silently rebuilding

UX Improvements

• Dialogs behave consistently; Esc no longer closes an entire stacked dialog chain at once
• The mascot got a full-body redesign — rounder, friendlier, more expressive

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

Command-Level Output Model (OSC 133)

• Shell integration (OSC 133) now marks each command's output range and working directory — zsh is wired up out of the box
• Relative paths in terminal output resolve against the command's working directory, not the current shell directory
• a/ and b/ prefixes and trailing markers in git diff output are cleaned up automatically, so clicks land on the real file
• Long paths broken across wrapped lines are correctly reassembled instead of splitting at the line break
• Hover detection is cached, so path resolution never slows down scrolling through heavy output

WebGL Renderer & Power Efficiency

• Terminal rendering defaults to WebGL (GPU) instead of per-cell DOM layout — renderer CPU under heavy output drops by ~90%
• New three-way toggle in Settings: Auto / Enable / Disable — Auto switches based on power source (battery saves power, plugged in gets full GPU)
• Fixed idle power consumption from persistent polling, unnecessary wakeups, and cursor blink during hidden windows
• Fixed resize cascade causing redundant redraws and DPI jitter

Session Restore Reliability

• Fixed session restore showing large blank areas after restart
• Fixed panel switching eating restored content
• Periodic session serialization ensures crash recovery uses recent state, not hours-old snapshots
• Atomic writes prevent settings corruption during crash mid-save

Listening Port Detection

• Automatically detects which ports workspace processes are listening on
• Live badges in the sidebar tab show service status at a glance — no more switching to run lsof

Host Detection

• Termdock identifies the environment on the other end of each session: local machine, SSH, or container
• Detection results feed into the terminal model, informing path resolution and future trust features
• Nested Termdock sessions now preserve correct identity variables

Agent Integration

• Claude Code permission requests matched by requestId — concurrent requests can no longer be mixed up
• Terminal API screen reads (mode=screen) prefer headless snapshots for more complete remote content
• Background session screens can be read reliably without depending on panel visibility

Text & Search Correctness

• Fixed search highlights misaligning on CJK characters and emoji — offsets unified from bytes to characters
• Text positions use branded types, making byte and character offsets impossible to mix at compile time
• AST query positions unified, so external tools get consistent line/column numbers

UX Improvements

• TodoPanel shows activation guide when Code Analysis is disabled or not enabled for the workspace
• Closing Code Analysis no longer triggers a false "system error" dialog
• window.open / target="_blank" links now open in the system browser instead of an internal window

Under the Hood

• Git diff parsing unified into a single shared data contract
• Scrollback storage uses an amortized O(1) structure for smoother scrolling through long output
• Removed ~1,500 lines of unused legacy code

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

Termdock v1.14.0

AST Worker Process & Code Graph

• AST service migrated to a dedicated utilityProcess — indexing no longer blocks the main process
• LSP features restored in worker mode
• Per-workspace AST toggle — enable or disable code analysis for each workspace
• Code graph MCP server available over stdio for external tool integration
• Fixed worker memory explosion on large codebases

Tool Runtime

• New unified Tool Runtime — all internal capabilities registered through a single registry with Zod validation
• Terminal, Git, and AST tools exposed through the runtime
• Directional code context graph tools for navigating callers, callees, and dependencies
• Command isolation and agent input attribution in the write coordinator

Terminal Stability

• Fixed session freeze caused by batch flush handle collision across timer types
• Fixed session freeze caused by forwarder flow-control credit exhaustion
• Fixed bracketed paste state tracking preventing terminal stuck in paste mode
• Fixed cross-chunk OSC escape sequence parsing
• Fixed tmux passthrough DCS wrapping silently dropping OSC notifications
• Detached terminals now restore from headless serialize instead of raw PTY replay

Workstream & Agent Hooks

• CLI hook installer for bridging agent events into the workstream
• Workstream replies to exit plans, generic questions, and permission hooks
• OSC 99/777 terminal notifications ingested as session attention events

UX Improvements

• Workspace path can now be edited in-place from the sidebar
• Unified fuzzy and wildcard matching across workspace search
• Long-running task sleep guard prevents unnecessary wake-ups
• Fixed idle power consumption from persistent animations and unthrottled background rendering

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

Termdock v1.12.0

Headless Terminals & Background Sessions

• Terminal sessions can now run in the background with full screen state, no visible renderer required
• New background terminal manager keeps long-running shells out of the active workspace
• Background sessions are backed by headless workers — output no longer floods the visible terminal buffer

Terminal API & CLI Control

• New Terminal Session CLI API for creating, operating, and attaching to sessions from the command line
• Terminal output can be streamed in real time via SSE to external consumers
• New layout commands allow scriptable workspace arrangement
• In-app Terminal API Guide added to the menu for quick setup reference and curl examples
• Commands now wait for shell readiness and output advancement before executing, preventing races during PTY startup

UX Improvements

• Upgraded xterm 6 contract support and synchronized output handling
• User scroll position is preserved while terminal output continues streaming
• Fixed xterm 6 background transparency
• Fixed absolute system path detection
• Control / Command shortcuts now work correctly with non-Latin keyboard layouts

Bug Fixes

• Fixed AST indexing memory bursts
• Background session output no longer leaks into the foreground renderer
• Agent session read paths are correctly retained after history session restoration
• Git changes and file viewer interaction polish

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

New Features

• CLI Control Interface — Added termdock identify --json command, allowing external agents or scripts to

query the currently focused workspace, pane, session, and more. To install: run npm link in the Termdock

project directory to make the termdock command available globally

• Renderer Diagnostics — Real-time memory usage, terminal lifecycle state, and watcher source attribution
• WriteIntent Write Classification — PTY writes now carry one of 7 semantic intents (command, paste, agent

input, etc.), laying groundwork for the upcoming write coordinator

Performance

• Git Changes Virtualization — Only visible rows are rendered when there are many file changes, eliminating

scroll jank

• Terminal Output Hot Path — Removed per-chunk diagnostics overhead for smoother high-volume output

Bug Fixes

• Rust PTY writes now correctly retry on system busy, preventing duplicate data
• Reopening a file already bound to a pane no longer mounts two editors
• File explorer search can now find files inside collapsed folders
• Git read-only operations no longer trigger fetch, avoiding lock contention with other git commands
• Terminal sessions properly clean up all associated resources on exit
• File watchers are correctly released when the last listener unsubscribes
• Agent sessions remain queryable after memory eviction
• AST tools show a clear error when called outside workspace scope

UI Improvements

• Text over background images gets an automatic readability scrim, tinted from the image's own colors
• Git graph label colors are now independent from the sidebar theme
• Git changes list uses a two-line layout, showing full file paths

Refactoring

• Terminal API server split into modular route files
• TerminalGrid deduplicated shared logic
• PTY worker extracted shared pause predicate

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

feat:

• Add improved theme support with better contrast handling
• Add optional enhanced terminal rendering mode
• Add smarter terminal text/link detection
• Add file preview support directly inside panes
• Add Markdown export to HTML

fix:

• Fix several terminal restore and resize stability issues
• Fix terminal cursor positioning after session restore
• Fix blank terminal cases after restoring sessions
• Fix pane focus and layout switching issues
• Fix file preview display issues across image, PDF, Markdown, and code views
• Fix file viewer search behavior
• Fix Git tag display issues
• Fix keyboard interaction issue when using spacebar in tabs

improve:

• Improve pane layout consistency across terminal and file previews
• Improve file viewer visual consistency in embedded and standalone modes
• Improve workspace grouping behavior

perf:

• Improve terminal output responsiveness under heavy streaming
• Reduce terminal rendering overhead during rapid output

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• feat: Workspace tag grouping (sidebar and Cmd+P grouped and collapsible by ‎workspace.tags; multi-tag workspaces appear in each tag group)
• feat: Agent session control API (soft interrupt, dispatch state query, session lifetime metadata)
• feat: Terminal API service tokens (daemon consumers no longer depend on user credentials)
• feat: Custom terminal font search paths (no longer limited to system default locations) #42
• fix: Terminal small-split ghosting fully resolved (visibility change defer fit + PTY winsize guard)
• fix: Agent session Claude composer prompt detection fixes (trimmed / interactive)
• fix: AI / API key config serialized writes to avoid corruption under concurrency
• fix: Token storage git token state shared across service instances to eliminate race conditions
• fix: Terminal API finer-grained output error classification for faster debugging
• fix: Terminal ‎appendEnter payload now preserves newline characters

繁體中文

• feat: Workspace tag grouping（側邊欄與 Cmd+P 依 ‎workspace.tags 自動分組，可摺疊；多 tag workspace 於各分組顯示）
• feat: Agent session control API（soft interrupt、dispatch state 查詢、session lifetime metadata）
• feat: Terminal API service tokens（daemon consumer 可不依賴使用者憑證）
• feat: 自訂終端字型搜尋路徑（不再受限系統預設位置）#42
• fix: Terminal 小分割殘影完整修復（visibility change defer fit + PTY winsize guard）
• fix: Agent session Claude composer prompt 偵測修正（trimmed / interactive）
• fix: AI / API key config 序列化寫入，避免併發損毀
• fix: Token storage git token 狀態跨 service instance 共用，消除 race condition
• fix: Terminal API 細粒度 output 錯誤分類，加速排查
• fix: Terminal ‎appendEnter payload 保留換行

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

中文：

1.8.1 是 1.8.0 後的穩定性修正版，主要修復 Terminal 高輸出量卡死、backpressure freeze、single-layout terminal regression、AST 啟動索引風險、token 寫入安全、Git/GitHub 設定 #41 與modal 小問題，並補齊 Terminal / Agent Session API 文件。

English:

1.8.1 is a stability patch after 1.8.0. It fixes Terminal freezes under heavy output/ backpressure, single-layout terminal regressions, AST startup indexing risk, token write safety, Git/GitHub settings #41 and modal issues, and improves Terminal / AgentSession API documentation.

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• Hidden / detached terminals no longer block the renderer
• Session lifecycle is decoupled from renderer attachment, so tab switches and panel hiding are cleaner
• Recovery is now event‑driven, reducing noisy polling
• Resize / fit / refresh / fallback now share a unified path, making long‑running session scrollback more stable
• Fixed render and pane identity issues when switching single‑layout tabs
• Claude / Codex / Gemini interactive providers now share a unified runtime surface
• Added an agent session event broker and SSE event stream
• Agent transcript is now a rendered view, so you no longer have to guess when monitoring flows
• Attach state is preserved while the session is still alive
• Exposed an agent‑oriented terminal API for external scripts
• Shared memory is now a structured entry store with a maintenance‑aware workflow
• Memory Library now has a review panel, so recall / remember / forget no longer require editing raw Markdown
• Workspace ownership is now worktree‑aware, so multiple worktrees no longer recompute independently
• Unicode .txt files are again opened as text instead of falling back to binary
• Repacked the darwin arm64 PTY binary
• Startup no longer forces AST indexing; AST now runs only inside a safe workspace
• Shut down leftover SSE subscriptions to avoid keeping resources after an agent session ends

繁體中文

• Hidden / detached terminal 不再卡住 renderer
• Session lifecycle 跟 renderer attachment 解耦，切 tab、隱藏面板都更乾淨
• Recovery 改成 event-driven，少了 noisy polling
• Resize / fit / refresh / fallback 路徑統一，長時間 session 的 scrollback 行為更穩
• 修好 single-layout tab 切換時的 render 跟 pane identity 問題
• Claude / Codex / Gemini interactive provider 走統一 runtime surface
• 加入 agent session event broker 與 SSE event stream
• Agent transcript 改成 rendered view，監看流程更順暢
• Attach state 在 session 還活著時會被保留
• 提供 agent-oriented terminal API 給外部腳本接
• Shared memory 改成結構化 entry store，加上 maintenance-aware workflow
• Memory Library 加上 review panel，recall / remember / forget 不用再手改 raw markdown
• Workspace ownership 變 worktree-aware，多 worktree 不再各自重算
• Unicode .txt 重新被當文字打開，不再掉到 binary fallback
• darwin arm64 PTY binary 重新打包
• Startup 不再強制 AST indexing，AST 鎖在 safe workspace 內運作
• 關掉殘留的 SSE subscription，避免 agent session 結束後仍佔資源

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• Major overhaul to AST / Code Analysis. Added core AST analysis, Git/workspace integration, Rust AST engine Phases 1–4, multi-language parsers, incremental indexing, on-disk persistence, background auto-indexing, workspace isolation, index‑first queries, Cargo workspace resolution, and dynamic computation for analysis metrics.
• Tool Runtime is now fully in place. Introduced a unified capability registry and a unified tool:call dispatcher, and folded more AST capabilities into the runtime. The code:search-files schema now supports roots and excludePatterns.
• Agent / Remote got a big upgrade. Remote read now uses the xterm DOM, the Terminal API supports multi‑session layout control and DOM screen reads, output semantics and the cursor contract are more stable, and remote watch now emits structured JSONL with PID parsing.
• Terminal / file UX pass. Reworked link detection, you can now carry line/column into the file viewer, session restore now reads visible lines only, and PTY fallback / drag-and-drop / pasting paths from Finder are all fixed. v1.6.1 also focused on tab notification false positives and mute behavior.
• Platform / UI / stability. Upgraded Electron from 28 to 41, added support for registering as the default file handler, version announcements, Discord Rich Presence, Buddy item events, persistent workspace expand/collapse state, FileTree performance improvements, and more consistent themes/icons/dialogs.
• Security / code health. Fixed an shell: true RCE risk, added build metadata (git hash / branch / timestamp), removed large amounts of dead/commented-out code, cleaned up stale specs/configs, and fixed memory leaks and watcher leaks.

---

• AST / Code Analysis 大改。補上核心 AST 分析、Git/Workspace 整合、Rust AST engine Phase 1-4、多語言 parser、增量索引、磁碟持久化、背景自動索引、workspace 隔離、index-first queries、Cargo workspace 解析、分析指標改成動態計算。
• Tool Runtime 正式落地。加入 unified capability registry、統一 tool:call dispatch，把 AST 能力往 runtime 收斂，code:search-files schema 也補齊 roots / excludePatterns。
• Agent / Remote 能力升級。remote read 改用 xterm DOM，Terminal API 支援多 session 版面控制與 DOM screen read，output semantics / cursor contract 更穩，remote watch 也變成結構化 JSONL + PID 解析。
• Terminal / 檔案體驗修一輪。link 偵測重做、可把 line/column 帶進 file viewer、session restore 改讀 visible lines、PTY fallback/drag-and-drop/Finder 貼路徑都修掉。1.6.1 另外集中修 tab 通知誤報與 mute 行為。
• 平台 / UI / 穩定性。Electron 28 -> 41、可註冊成文件預設讀取器、加入 version announcement、Discord Rich Presence、Buddy 道具事件、workspace 展開狀態持久化、FileTree 效能優化、主題/圖示/彈窗一致性整理。
• 安全 / code health。修掉 shell: true 的 RCE 風險，補 build metadata（git hash / branch / timestamp），大量刪除 dead/commented code、清 stale spec/config，外加 memory leak / watcher leak 修正。

Installation Instructions

1. Download the installer for your platform

2. On macOS, open the DMG and drag Termdock to Applications folder

3. On macOS, first launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

繁體中文

新增功能

1. 新增 Windows 版支援

2. 透過 Telegram / Discord Bot 指令控制遠端終端機，也可以即時截圖

3. 提供 Agent API 控制 Terminal

4. UI 重構，大幅減少框線和邊界，背景圖可延伸至側邊欄

5. 根據背景圖片自動偵測 theme (建議深色一點的圖)

沒用的小功能

1. Termdock 會趁你閒置的時候出來搗亂

2. 在 Discord 狀態中顯示目前終端活動

修正

1. 減少誤判活動偵測，降低噪音

2. 分頁自訂名稱持久化，包含 restore 時也會繼承

3. 修正路徑偵測部分錯誤

4. 修正輸入框在渲染時會清空輸入內容的問題

5. 修正開啟設定頁的時有機率觸發主視窗捲軸

6. 修正關閉主程式、清理與錯誤路徑的穩定性

7. 統一 Git 工具列狀態指示邏輯及暫存錯誤問題

8. 避免在記憶體超過 100MB 時 UI 直接卡死（SBOD）#36

English

New Features 

1. Added Windows support

2. Control remote terminals via Telegram / Discord bot commands, with live screenshot capture

3. Agent API for programmatic Terminal control

4. UI overhaul: significantly reduced borders and lines; background image can now extend into the sidebar

5. Automatically detects a suitable theme based on the background image (a slightly darker image is recommended)

Minor / Fun Features

1. Termdock will occasionally pop up and mess with you when you’re idle

2. Shows current terminal activity in your Discord status

Fixes

1. Reduced false positives in activity detection to lower noise

2. Tab custom names are now persisted and also restored correctly on app restart

3. Fixed several issues in path detection

4. Fixed an issue where the input field would clear its content during rendering

5. Fixed a bug where opening the settings page could sometimes trigger scrolling of the main window

6. Improved stability when closing the app, cleaning up resources, and handling invalid paths

7. Unified the logic for the Git toolbar status indicators and fixed staging-related errors

8. Avoid the UI completely freezing (SBOD) when memory usage exceeds 100 MB. #36

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

English

• Session Restore — Automatically restores terminal sessions after app restart, with serialization safeguards and per-session error isolation
• PTY Process Isolation — Injects isolation at the PtySession level via WorkerPtyProxy, running each PTY in a dedicated utilityProcess
• Unified TermdockPaths Management — Consolidates all ‎.termdock paths into a single TermdockPaths source, including workspace migration
• Git Changes Badge — UI shows a badge with the number of git changes
• Terminal Shift+Enter Newline — Terminal now supports inserting a new line with Shift+Enter Refactor
• AST IPC V2 Facade — Consolidates AST IPC into a unified V2 facade with a type-safe interface Bug Fixes
• Bind AST API to 127.0.0.1 — Changes AST API listen address from ‎localhost to ‎127.0.0.1 to avoid DNS resolution issues
• Memory Skill Script Path Resolution — Fixes incorrect skill script path resolution

繁體中文

• Session Restore — 應用重啟後自動恢復終端 session，包含序列化保護與 per-session 錯誤隔離
• PTY Process Isolation — 透過 WorkerPtyProxy 在 PtySession 層級注入隔離，PTY 運行於獨立 utilityProcess
• TermdockPaths 統一路徑管理 — 將所有 .termdock 路徑收斂至 TermdockPaths 單一來源，含 workspace migration
• Git Changes Badge — UI 顯示 git 變更數量標記
• Terminal Shift+Enter 換行 — 終端支援 Shift+Enter 插入新行
• AST IPC V2 Facade — 整合 AST IPC 為統一的 V2 facade，type-safe interface
• AST API 綁定 127.0.0.1 — 修正 AST API 監聽位址從 localhost 改為 127.0.0.1，避免 DNS 解析問題
• Memory skill 腳本路徑解析 — 修正 skill script 路徑錯誤

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

v1.5.1 - en

Git Branch Management

• Fixed an issue where deleted remote branches still appeared in the panel: now automatically runs ‎fetch --prune after deleting a remote branch to clear stale remote tracking refs and keep the branch list up to date.
• Fixed the incorrect “deleting current branch” detection: the ‎deleteLocal flag now properly guards the current-branch check, so deleting only a remote branch is no longer blocked by mistake.
• Fixed hardcoded error messages: when some deletions fail (for example due to insufficient permissions), the UI now returns the actual error instead of always showing “Branch not found”.
• Fixed duplicate local branch deletions: the previous flow attempted to delete the same local branch twice. It now deletes the branch only once and refreshes the branch list correctly afterward.
• Fixed a cleanup memory leak: ‎lastPruneTime is now cleared during the cleanup phase to prevent a minor memory leak.

Terminal

• Fixed broken paste behavior in the terminal: reduced over-aggressive filtering of OSC responses and corrected terminal capability detection so paste and related features work normally again.

Memory Skill

• Fixed ‎remember.sh not calling the API: the memory script now correctly invokes the API, restoring search functionality.
• Added ‎trap cleanup to ‎install.sh: temporary files are now automatically removed when the script exits unexpectedly, preventing leftover artifacts.

Refactor

• GitBranchList / GitBranchSelector: moved ‎loadBranches and cleanup logic into a shared ‎finally block to reduce duplicated code and make resource cleanup more consistent.

v1.5.1 - tw

Git Branch Management

• 修正刪除遠端分支後，面板仍顯示過期分支的問題：在刪除遠端分支時自動執行 ‎fetch --prune，清除過期的 remote tracking refs，確保分支列表能即時更新。
• 修正「刪除當前所在分支」的誤判問題：‎deleteLocal 旗標未正確保護當前分支檢查，導致只刪除遠端分支時也被錯誤阻擋，現已修正。
• 修正錯誤訊息被硬編碼覆蓋的問題：當部分刪除失敗（例如權限不足）時，錯誤訊息不再一律顯示為「Branch not found」，會回傳實際錯誤原因。
• 修正本地分支重複刪除問題：原刪除流程中本地分支被刪除兩次，現已調整為只刪除一次，並在刪除後正確刷新分支列表。
• 修正 cleanup 記憶體洩漏問題：‎lastPruneTime 紀錄未在 cleanup 階段被清除，會造成輕微的記憶體洩漏，現已修復。

Terminal

• 修正終端貼上功能損壞問題：停止過度過濾 OSC 回應並修正終端能力偵測，恢復貼上等相關功能的正常運作。

Memory Skill

• 修正 ‎remember.sh 未呼叫 API 的問題：記憶儲存腳本未正確呼叫 API，導致搜尋功能無效，現已修復。
• ‎install.sh 新增 ‎trap cleanup：當腳本異常中止時，暫存檔會自動清理，避免殘留檔案。

Refactor

• GitBranchList / GitBranchSelector：將 ‎loadBranches 與 cleanup 邏輯統一移至 ‎finally 區塊，減少重複程式碼並讓資源釋放流程更一致。

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• 整合 Whisper 語音輸入，支援快捷鍵與開關

Integrate Whisper voice input with keyboard shortcuts and an on/off toggle.

• 側邊欄待辦清單，支援標籤與一鍵把任務丟給 AI

Sidebar to‑do list with tag support and one‑click handoff of tasks to AI.

• Rust PTY Acceleration：改善大流量寫入表現

Rust PTY Acceleration: optimized high‑throughput write performance.

• 移除自動附加附件 Prompt

Removed the automatic attachment prompt.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• 新增單一panel 可靜音通知
• 新增 changelog 快速查詢，可在about頁面瀏覽
• Add ability to mute notifications for a single panel.
• Add quick changelog lookup, viewable on the About page.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• 加強啟動 Termdock 的效能，將非必要的載入延後，首次使用的人可能依然會比較慢一點
• 完成通知
• 增加 app 未讀統計，你需要開啟系統通知權限
• 在 active 的 tab 離開視窗也會通知了，你可以直接去看電影等通知
• 歷史會話改善
• 可在歷史紀錄直接 resume 對話，或選取文字快速 fork。
• 對話紀錄版面更易讀。
• 日期分組與黏附標頭（sticky headers）。
• 訊息數量統計更清楚。
• 採用聊天氣泡樣式，區分用戶與 AI 訊息。
• 顯示 AI Provider 專屬圖示（Claude、GPT、Gemini）。
• 修正 URL 偵測邏輯
• 偵測到 URL 開啟系統瀏覽器
• Improved Termdock startup performance by deferring non-essential loads; first-time users may still experience some slowness.
• Completion notifications

▫ Added app unread count; you’ll need to enable system notification permissions.

▫ Notifications now trigger even when the active tab leaves the window, so you can step away and still receive alerts.

• Conversation history improvements

▫ Resume conversations directly from history, or select text to quickly fork a new thread.

▫ More readable conversation log layout.

▫ Date grouping with sticky headers.

▫ Clearer message count statistics.

▫ Chat bubble styling to distinguish user vs. AI messages.

▫ Provider-specific icons for AI (Claude, GPT, Gemini).

• Fixed URL detection logic

▫ Detected URLs now open in the system browser.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• Sound notifications: When terminal output stops (idle state), a chime plays to notify you that the AI tool has finished responding.
• Visual indicators: Each terminal tab label shows activity status
• 🟢 Green pulsing dot = actively outputting
• ⚪ Gray dot = waiting/idle
• Custom sounds: Supports custom audio files (MP3, WAV, OGG, M4A), configurable in Settings.
• Smart filtering: Automatically ignores input echo, resize events, and startup initialization to reduce false alerts.
• Independent toggles: The master mute toggle and custom sound toggle are fully independent and do not interfere with each other.
• 聲音通知：當終端輸出停止（進入 idle 狀態）後，播放提示音通知你 AI 工具已完成回應
• 視覺指示器：每個終端 Tab 標籤顯示活動狀態
• 🟢 綠點脈衝 = 正在輸出中
• ⚪ 灰點 = 等待/閒置中
• 自訂音效：支援自訂音效檔案（MP3、WAV、OGG、M4A），可在設定中配置
• 智慧過濾：自動忽略輸入回顯、resize 事件及啟動初始化，減少誤報
• 獨立開關：主靜音開關與自訂音效開關完全獨立，互不干擾

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• #30: [Bug] 修正 Git 未暫存數量的錯誤：先前只計算新加入的檔案。
• #29: [Feature] 改善 Claude Code，避免它意外跳回頂端。
• #28: [Bug] 修復終端機底部間距問題。
• #26: [Experimental] 攔截高風險指令並提供警示。
• #25: [Feature] 自動偵測可執行的程式碼與測試，並支援一鍵執行。
• #16: Feature] 支援將外部檔案拖曳到 FileExplore。
• #30: [Bug] Fix git unstaged count bug: it only counted newly added files.
• #29: [Feature] Improve Claude Code to prevent it from unexpectedly jumping back to the top.
• #28: [Bug] Fix terminal bottom spacing.
• #26: [Experimental] Intercept high-risk commands and provide warnings.
• #25: [Feature] Auto-detect runnable code and tests with one-click Run
• #16: Feature] Support dragging files into FileExplore from outside the window.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

##繁體中文

• [#14] 實驗功能： 可調整大小的面板（Resizable Panel）
• [#20] 錯誤修復： Git 工具列顯示的分支清單不完整
• [#21] 錯誤修復： 在 Git 面板刪除分支時出現不必要的提示
• [#23] 錯誤修復： Git 變更工具列面板位置不正確
• [#24] 熱修（hotfix）： 分頁名稱顯示錯誤

English

• [#14] [Experimental] Resizable Panel
• [#20] [Bug] The Git toolbar displays an incomplete list of branches
• [#21] [Bug] delete-branch prompts in the Git panel.
• [#23] [Bug] Git changes toolbar panel positioned incorrectly.
• [#24] [hotfix] Tab name error

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

• [#19] Refactor the logic that inserts the terminal into the grid panel

• [#18] Fix the issue where child windows cannot be opened.

• [#10] Inline Git Blame: see per‑line author and commit in Code mode.

• [#15] Git Changes collapsible: collapse staged/unstaged sections freely.

• [#9] Git panel shows full file names.

• [#11] Code and PDF can display in panels (Experimental). Grid layout is not supported yet. use the file’s context menu and select Open in Panel to display it inside a TermDock panel.

• [#17] Path detection and overall stability improved.

• [#12] Configurable default Shell.

• [#6] Fixed Git event monitor so auto‑updates don’t stop on long runs.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

繁體中文

#2

1. Pty 修正： 嘗試修正 pty，使其在執行時正確載入 x64 / arm64 架構的二進位。

2. 公證簽名： 補上（或恢復）macOS 的公證簽名，確保所有 x64/arm64 安裝檔已正確簽署並通過 Gatekeeper。

3. 錯誤日誌回報（x64）： 若 x64 使用者仍無法啟動終端機，應會跳出錯誤日誌視窗；按下「OK」後，請將日誌貼到 Issue，感謝協助。

English 

#2

1. Pty fix: Adjust pty so the app loads the correct x64/arm64 binaries at runtime.

2. Notarization: Add/restore macOS notarization to ensure all x64/arm64 artifacts are properly signed and pass Gatekeeper.

3. Error log (x64): If x64 users still can’t start the terminal, an error log dialog should appear; after clicking “OK,” please paste the log into the issue. Thank you.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

繁體中文

修正終端機連線問題 (#2 )

在打包過程中沒有針對各架構重新編譯 node-pty，導致 x64 版本的 TermDock 內含了 arm64 的 node-pty。當在 x64（Intel） 上執行時，系統嘗試載入 arm64 的 node-pty，因架構不相容而連不上 Terminal。

English

Fixed Terminal connection error (#2 ). Connection flow is more stable with clearer retry prompts

During packaging, node-pty wasn’t rebuilt per architecture, so the x64 build bundled the arm64 node-pty. When running on x64 (Intel), it attempted to load the arm64 binary, causing an architecture mismatch and the Terminal failed to connect.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

繁體中文

• 新增 AST 分析依賴及呼叫關係互動圖表
• 修正 AST 索引問題，提升解析與查詢穩定度
• 修正 Monaco 觸發的 race condition 與記憶體洩漏
• 修正 UTF‑8 切割邊界導致的崩潰
• 修正 PTY 原生模組崩潰
• 修正 Git 多終端監控異常

English

• Add interactive graphs for AST analysis: dependencies and call relationships
• Fix AST indexing issues to improve parsing and query stability
• Fix Monaco-triggered race conditions and memory leaks
• Fix crashes caused by UTF‑8 boundary splitting
• Fix PTY native module crashes
• Fix Git multi-terminal monitoring anomalies

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

繁體中文

• 修復：事件監聽器導致的記憶體洩漏

• 修復：Git 競爭問題

• 改善：多 Terminal 情境下的 Git 監控一致性與穩定性

• 最佳化：降低記憶體增長

• 最佳化：多專案操作時的整體效能表現

English

• Fixed: memory leak in event listeners

• Fixed: Git race conditions

• Improved: consistency and stability of multi-terminal Git monitoring

• Reduced memory growth

• Optimized: overall performance with multiple repositories

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

繁體中文

• 新增：長按「建立 Terminal」按鈕，可快速在根目錄開啟臨時 Terminal（不含 Git 功能），方便進行短暫操作與環境檢查。
• 修正：改善錯誤管理流程並處理 node-pty 相關錯誤，提升穩定性與錯誤可追蹤性。
• 修正：修復 Monaco 編輯器的記憶體洩漏問題，降低資源占用並改善長時間使用的流暢度。

English

• New: Long-press the “Create Terminal” button to open a temporary terminal at the project root (without Git features), ideal for quick tasks and environment checks.
• Fix: Improved error handling and resolved node-pty related issues for better stability and traceability.
• Fix: Addressed a memory leak in the Monaco editor to reduce resource usage and improve long-session performance.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

English

Fixed an issue where the original source view could not be toggled when viewing diffs in Git Change.

繁體中文

修正於 Git Change 檢視 diff 時，無法切換「原始碼檢視」的問題。

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

#### English

Emergency Fix: Resolved an issue where git graph could not read files.

#### 繁體中文

緊急修正：修復 git graph 無法讀取檔案的問題。

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

#### English

• Fixed node-pty errors during spawn and interaction, improving terminal stability and compatibility

• Fixed Git Graph not showing commit changes for staged files

• Fixed Git Diff not rendering changes for deleted files

• Fixed UI layering (z-index) where the Git file list modal could be covered by the Diff viewer

#### 繁體中文

• 修正 node-pty 啟動與互動時的錯誤，提升終端穩定性與相容性

• 修正 Git Graph 無法檢視「已暫存（staged）」檔案之 commit 變更

• 修正 Git Diff 無法顯示「刪除檔案」的差異內容

• 修正 Git 檔案清單彈窗被 Diff 檢視彈窗遮蓋的視覺層級問題（z-index）

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

修正：

• 修正穩定度
• 調整新增 Terminal 及分割視窗按鈕的位置

Fixes:

• Improved stability
• Adjusted the position of the “New Terminal” and “Split Window” buttons

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

Supports automatic updates.

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.

feat

• Added split page mode

fix

• Fixed GitHub OAuth
• Fixed memory leak cleanup

Installation Instructions

1. Download the appropriate DMG file for your Mac

2. Open the DMG and drag Termdock to Applications folder

3. First launch may require allowing the app in System Preferences > Security & Privacy

Report Issues

Found a bug? Please report it in our Issues section.