新功能
--project 支援直接輸入專案名稱
現在啟動命令列時指定專案更加直覺，直接輸入專案名稱就能載入。以前 --project 參數只接受專案 ID，輸入其他值就會顯示錯誤；現在你可以直接輸入好記的專案名稱。例如輸入 agy --project "my-cool-app" 就能順利開啟，不用再特地去後台翻查並貼上冗長的專案 ID 代碼。
繁體中文
新功能
對話改名與刪除支援自訂快捷鍵
使用沒有功能鍵（F 鍵）的精簡鍵盤時，在對話挑選器裡想快速改名或刪除紀錄，以前常因按不到 F2 或 F4 而卡住。現在系統在 keybindings.json 設定檔中新增了 item.rename 與 item.delete 兩個快捷鍵綁定項目，讓你自由替換預設的 f2 與 f4。你只需在設定檔中加入以下內容，就能改用自訂按鍵：
{
"item.rename": "ctrl+r",
"item.delete": "ctrl+d"
}新功能
@ 檔案路徑補齊支援容錯搜尋
當你在提示列輸入 @ 搜尋檔案路徑時，難免會手滑按錯相鄰字母或顛倒順序。
現在檔案補齊機制加入了容錯備援（fallback）功能。即便搜尋字串中有打錯或位置調換的字元，系統依然能找到你想引用的檔案。同時，容錯比對出的候選檔案排序永遠不會超越完全精準符合的結果，確保你精確輸入時不會被雜訊干擾。
新功能
支援附加 WAV、MP3 等常見音訊格式
現在你可以直接把各類常見的錄音檔案附加到對話中，交給模型分析。先前即使 Gemini 模型本身支援多種音訊，命令列工具卻會將常見格式誤判為不支援而拒絕附加；現在系統已能正確辨識這些標準音訊格式。包括 wav、mp3、m4a、aac、flac 與 opus 在內的六種檔案，現在都能順暢附加並送出。
效能優化
Windows 輸入反應加快，捨棄多餘放開按鍵事件
在 Windows 系統上，主控台（console，負責處理文字輸入輸出的視窗元件）在使用者每次按鍵時，都會同時回報「按鍵按下」與「按鍵放開」兩筆事件。然而命令列工具根本不需要讀取按鍵放開的動作，導致過往每敲一個字元，背後幾乎都承受了兩倍的畫面渲染（rendering，把文字繪製到螢幕上的過程）工作量。現在系統會主動忽略這些無用的放開事件，大幅減輕負擔並讓打字反應更加靈敏。
新功能
產物檢視器整合大綱與翻頁提示
當你在產物（artifact，對話產生的程式碼或文件檔案）檢視器中閱讀長篇文件時，底部的導航提示現在更加一目了然。先前大綱快捷鍵與其他移動提示分散在不同位置，查找時不夠直覺；現在系統把開啟大綱的按鍵移到了捲動與翻頁提示旁邊。如此一來，逐行捲動、整頁翻動以及依據大綱章節跳轉這三種移動方式，便整齊歸納在同一個操作群組中。
問題修復
列印模式中斷時正確回報非零錯誤碼
使用列印模式（-p，直接把回答輸出到終端機而不進入互動畫面的無頭模式）自動化腳本時，最怕中途出錯卻被當成成功。先前若代理程式狀態串流在執行途中意外中斷，系統只會吐出空白內容，卻依然回報成功結束，導致外部自動化流程誤以為任務順利完成。現在系統修復了這個判定缺陷，發生串流中斷時會清楚印出具體的串流錯誤，並以非零狀態碼退出。
問題修復
修正命令列旗標誤吞問題，防範沙盒未啟動
在命令列中組合使用多個旗標時，若某個提示詞旗標未帶參數，過往解析器會錯誤地把下一個旗標吞進去當成提示詞內容。例如輸入 --print --sandbox 'do the task' 時，系統先前會把 --sandbox 當作提示詞送出，導致沙盒防護根本沒有開啟。現在系統修正了參數解析邏輯，不但不會再錯誤吞噬後續旗標，且遇到未接值的旗標或多餘的結尾引數時，都會直接顯示錯誤並阻止執行。
問題修復
/btw 卡片限制畫面高度並支援鍵盤捲動
在對話中開啟側邊提問的 /btw 卡片時，若 AI 給出落落長的回覆，展開的卡片以前會一路往下延伸，把底部的快捷鍵提示和輸入列硬生生擠出螢幕外。現在系統會將展開的卡片高度限制在終端機畫面高度之內。當回答內容過長時，你可以直接使用上下方向鍵或翻頁鍵（Page Up 與 Page Down）在卡片內捲動閱讀，不再破壞整個畫面的排版。
問題修復
/resume 正確聚焦於子目錄所屬的工作區
當你在專案子目錄中工作並輸入 /resume 想繼續先前的對話時，畫面焦點先前會莫名其妙跳到別處。
以前只要命令列是從工作區的子資料夾啟動，對話挑選清單就不會自動定位到當前專案，反而會滾動到折角下方看不見的位置；現在這項跳頁問題已經修復。系統會正確辨識你所屬的專案工作區，一打開就精準聚焦在當前的對話清單上。
問題修復
檔案連結不再清除同一行後續文字樣式
在終端機輸出中，檔案名稱常會以可點擊的連結形式呈現。先前因為連結結尾的終端機重設指令範圍過大，在重設連結樣式的同時，把同一行後續文字的顏色與粗體等排版樣式也一併清空了；現在系統已修正此項樣式重設邏輯。檔案連結之後的文字現在能完整保留原有的樣式與色彩，不再莫名變回單調的純文字。
問題修復
消除提示列定期跳出的雜訊字元
在某些終端機中打字時，輸入列每隔幾秒就會突然冒出一個多餘的雜訊字元，嚴重干擾打字節奏。這起因於系統過往會週期性送出指令來重新確認輸入模式，而部分終端機會把這些控制訊號當成一般文字印在畫面上。事實上，只有終端機多工器（terminal multiplexer，如 tmux 這種能在單一視窗中分割多個虛擬終端機的工具）才會在背後悄悄變更輸入模式。因此系統現在改為只在多工器環境下才發送重新確認指令，徹底消除了常規終端機上的跳字雜訊。
English
FEATURE
--project now accepts project names
Specifying a workspace project from the command line is now much more straightforward, as you can pass a project name directly. Previously, the --project flag only accepted a project ID and failed with an error on anything else; it now accepts human-readable project names. For example, running agy --project "my-cool-app" works directly without having to look up and paste an obscure project ID.
FEATURE
Custom keybindings for renaming and deleting conversations
If you use a compact keyboard without physical function keys, renaming or deleting history in the conversation picker used to be frustrating without easy access to F2 or F4. The system now introduces item.rename and item.delete in keybindings.json, allowing you to rebind the default f2 and f4 shortcuts. You can map them to custom combinations by adding the following snippet to your configuration:
{
"item.rename": "ctrl+r",
"item.delete": "ctrl+d"
}FEATURE
@ file path completion adds typo tolerance
When typing @ to complete a file path, it is easy to accidentally transpose characters or mistype an adjacent key.
The file path completion now includes a typo-tolerant fallback mechanism. Even if your query contains swapped or incorrect characters, it still retrieves the file you meant. Furthermore, typo-based matches will never outrank exact matches, ensuring accurate queries remain prioritized.
FEATURE
Audio attachments now recognize WAV, MP3, and standard formats
You can now attach everyday audio recordings directly to your conversations for model analysis. Previously, even though Gemini models natively accept multiple audio formats, the CLI would reject standard audio files as unsupported; the tool now properly recognizes these standard formats. Files in wav, mp3, m4a, aac, flac, and opus can now be attached without friction.
PERF
Windows typing responsiveness boosted by dropping key-release events
On Windows, the console fires both key-down and key-release events for every keystroke. Because the CLI never reads key releases, this previously roughly doubled the rendering workload for every single letter typed. The system now discards these unused key-release events immediately, noticeably boosting typing responsiveness.
FEATURE
Artifact viewer clusters outline and paging shortcuts
When reading long documents in the artifact viewer, the navigation hints at the bottom of the screen are now much easier to digest. Previously, the outline shortcut was separated from other movement controls; it has now been moved right next to the scroll and page hints. This groups the three navigation methods — scrolling line by line, paging, and jumping via document outline — into a single unified set.
BUGFIX
Print mode now surfaces stream drops and exits non-zero
When automating workflows in print mode (-p), having a broken run reported as a clean success can easily slip unnoticed into automated pipelines. Previously, if the agent state stream was dropped mid-run, the CLI printed an empty response and exited cleanly with success, masking the failure. It now surfaces the stream error directly to the terminal and exits with a non-zero status code.
BUGFIX
CLI flags no longer swallow subsequent arguments
When combining flags in the CLI, an empty prompt flag previously swallowed the subsequent flag as its prompt text. For instance, running --print --sandbox 'do the task' used to execute with --sandbox as the prompt while silently leaving the sandbox disabled. The CLI now corrects flag parsing: this mistake and stray trailing arguments now immediately halt with clear errors.
BUGFIX
/btw cards clamp to terminal height and support scrolling
When opening a /btw side-question card during a conversation, an extensive response previously stretched the card downward endlessly, shoving the footer hints and the input prompt completely off-screen. The expanded card is now properly clamped to the height of your terminal. When an answer is long, you can scroll through it using the arrow keys and page keys (Page Up and Page Down) without disturbing the rest of the interface.
BUGFIX
/resume focuses on active workspace from subdirectories
When working inside a subdirectory and running /resume to pick up a previous chat, the list view used to jump to an unexpected location.
Whenever the CLI was launched from a subfolder of your workspace, the conversation picker failed to land on your current workspace, scrolling down below the visible fold. This focusing issue is now fixed, immediately centering on the workspace you are currently in.
BUGFIX
File links no longer strip styling from the rest of the line
In terminal output, file paths are often formatted as clickable links. Previously, the ANSI reset sequence at the end of a link overreached, inadvertently wiping out the color, bolding, and other styles of all remaining text on that line. The link styling logic is now isolated: prose following a file link retains its intended formatting without dropping back to plain text.
BUGFIX
Eliminating stray characters appearing in the prompt
When typing in certain terminals, a stray ghost character used to pop up in the input prompt every couple of seconds, interrupting your flow. This occurred because the CLI periodically refreshed its terminal input mode, and some terminals echoed those escape sequences as literal text. In practice, only a terminal multiplexer (a tool like tmux that manages multiple virtual terminal sessions within one window) resets these modes behind the scenes. The CLI now restricts periodic re-arming exclusively to multiplexer environments, eliminating phantom characters on standard terminals.
原始 CHANGELOG
Original changelog--project 支援直接輸入專案名稱
Added support for passing a project name to `--project`, which previously accepted only a project ID and failed on anything else.Original changelog對話改名與刪除支援自訂快捷鍵
Added `item.rename` and `item.delete` keybindings for the conversation picker's rename and delete actions, so `f2` and `f4` can be rebound in `keybindings.json` on keyboards without function keys.Original changelog@ 檔案路徑補齊支援容錯搜尋
Improved `@` file path completion with a typo-tolerant fallback, so a query with a transposed or mistyped character still finds the file; typo matches never outrank exact ones.Original changelog支援附加 WAV、MP3 等常見音訊格式
Improved audio attachments by recognizing the standard formats Gemini models accept, including `wav`, `mp3`, `m4a`, `aac`, `flac` and `opus`, which were previously refused as unsupported.Original changelogWindows 輸入反應加快，捨棄多餘放開按鍵事件
Improved keystroke responsiveness on Windows by discarding the key-release events the console reports and nothing in the CLI reads, which were roughly doubling the rendering work per keystroke.Original changelog產物檢視器整合大綱與翻頁提示
Improved the artifact viewer footer by moving the outline shortcut next to the scroll and page hints, so the three ways to move through a document read as one group.Original changelog列印模式中斷時正確回報非零錯誤碼
Fixed print mode (`-p`) exiting successfully with an empty response when the agent state stream was dropped mid-run, which reported a failed turn as a clean success; it now surfaces the stream error and exits non-zero.Original changelog修正命令列旗標誤吞問題，防範沙盒未啟動
Fixed a valueless prompt flag swallowing the next flag as its prompt, so `--print --sandbox 'do the task'` no longer runs with the prompt `--sandbox` and the sandbox off; both that and a stray trailing argument are now errors.Original changelog/btw 卡片限制畫面高度並支援鍵盤捲動
Fixed an expanded `/btw` card pushing the footer hints and the prompt off-screen on a long answer, which is now clamped to the terminal height and scrollable with the arrow and page keys.Original changelog/resume 正確聚焦於子目錄所屬的工作區
Fixed `/resume` opening below the fold instead of on the workspace you are working in, which happened whenever the CLI ran from a subdirectory of that workspace.Original changelog檔案連結不再清除同一行後續文字樣式
Fixed text losing its styling for the rest of a line after a file link, where the link's own reset also reset the surrounding prose.Original changelog消除提示列定期跳出的雜訊字元
Fixed a stray character appearing in the prompt every couple of seconds on terminals that print the CLI's periodic input-mode re-arming as literal text; the re-arm now happens only inside a terminal multiplexer, which is the only thing that resets those modes behind the CLI's back.