TUI 指南
單一 bubbletea textarea（internal/runtime/tui）；斜線指令開啟短暫 popup，關閉後乾淨回到輸入提示。
快捷鍵
| 按鍵 | 動作 |
|---|---|
Enter |
送出當前輸入。若有執行中的任務，改為將文字排入 steer 佇列，遞送給執行中的迴圈 |
Alt+Enter |
插入換行 |
/ |
開始斜線指令過濾（popup 選單——Up / Down 移動、Tab / Enter 補進 textarea、Esc 關閉） |
Up / Down |
游標位於第一行 / 最後一行時瀏覽輸入歷史（per-session .cmd_history 檔） |
Esc |
關閉指令選單；執行中時開啟取消確認 popup；其餘情況清空非空的輸入 |
Ctrl+C |
執行中時取消任務；否則印出 ctrl+c again to quit。3 秒內再按一次 Ctrl+C 即離開 TUI |
單鍵切換僅在輸入為空且無執行中任務時生效：
| 按鍵 | 動作 |
|---|---|
Shift+Tab |
切換 auto 模式（[safe] ↔ [auto]） |
Shift+F |
切換 fast 模式——啟用時標題列顯示 [fast] |
Shift+U |
即時供應商用量 / 餘額 |
Shift+W / Shift+S |
向前 / 向後輪替 dispatcher 模型 |
Shift+A / Shift+D |
調降 / 調升 reasoning 等級 |
Shell 指令模式（Shift+T）已移除；請改為請 agent 執行該指令。Shift+M 模型清單已移除；請用 /model，它會列出已註冊模型。
清單型 popup 中，Enter 確認選中項，d 刪除、t 設定 tier（僅在該 popup 提供這些動作時）。文字輸入型 popup 以 Ctrl+S 確認、Enter 換行、Esc 取消。
TUI 自動 tail 當前 session 的 action.log（外部行程寫入的行以 warn-purple 的 ▌ 前綴標示）。僅單一 session 檢視。
模式
當前模式顯示於 TUI 左下角：
[safe]（預設）—— tool call 執行前需使用者確認[auto]—— 所有 tool call 自動核准（allowAll = true）；沙箱與 validator 仍然生效[fast]—— 透過go-llm-router傳遞provider.ModeFast，讓支援的供應商後端要求更快的服務層級
Auto 模式為 session 區域性設定，TUI 重啟後重置。Fast 模式為行程區域性，不會寫入 config.json。
斜線指令
| 指令 | 說明 |
|---|---|
/model |
列出已註冊模型（Enter 選為 session 模型、d 移除、t 設定 tier S / A / B / C / pass），並提供動作 add（從供應商新增模型）、dispatch、summary、image、stt、tts。每個動作也可當子指令使用，例如 /model add |
/mcp |
列出 MCP server · 新增 · 逐台登入（瀏覽器 OAuth）、重連、檢視工具、逐工具權限、移除 |
/sessions |
Session 選單——Enter 切換、d 刪除。/sessions <name> 直接切換 |
/new |
建立 session（檢查名稱衝突） |
/allow-skill |
將 skill 標為 always-allow（略過權限確認），範圍為 global（~/.config/agenvoy/allow_skill）或 project（.agenvoy/allow_skill） |
/compact |
透過 LLM 分析移除歷史中冗餘的對話——需確認 |
/reset |
重置當前 session——需二次確認；先重新產生摘要，再清除歷史、任務歷史與 action.log |
/bot |
編輯 / 改名當前 session —— 名稱、self id 與描述（人格） |
/rule |
列出 / 新增 / 編輯 session prompt rule —— 標題 + 描述 |
/note |
列出 / 新增 / 編輯 operator note —— 標題 + 描述。v0.35.4 起由 /knowledge 更名 |
/channel |
啟用 / 停用 Telegram 或 Discord bot（啟用時驗證 token）。任一啟用後，admin 可設定新聊天驗證碼的轉發對象。子指令：telegram discord admin |
/config |
可搜尋的設定：Startup on login（macOS 為 launchd agent、Linux 為 systemd user unit）、Reply language、Output dir |
/schedule |
週期性（cron）與一次性（task）項目合併於同一清單——Enter 立即觸發、d 刪除。新增或編輯排程請直接請 agent 處理 |
/sched-<name> |
手動觸發既有 scheduler skill 內容。依 session 過濾——只顯示綁定於當前 session task / cron 項目的 skill |
/update |
取得最新 release、重新編譯並離開 TUI（以 agen 重新接上） |
/resume |
重新載入可見對話——action.log 的最後 100 筆 |
/log |
以 $PAGER（less +F）追蹤原始 daemon.log；Ctrl-C 停止追蹤 |
/usage |
各模型 token 用量——上方為當前 session、下方為全域——24 小時 / 7 天 / 28 天 |
/pending |
列出 / 續跑中斷的任務 —— 錯誤復原與 ask_user 續跑 |
/key |
從已記錄的 key 清單挑選並更新 / 輪替 keychain 值 |
/clear |
清除可見對話 —— 不動記憶 |
/exit |
離開 TUI（daemon 持續執行）；/quit 為別名 |
已無 /switch，請用 /sessions。已無 /dangerous，刪除 session 請在 /sessions 按 d，標記 skill 請用 /allow-skill。已無 /memory，請用 /compact 與 /reset。已無 /discord、/telegram、/admin-channel，請用 /channel。已無 /startup，請用 /config。已無 /cron 與 /task，請用 /schedule。
已無 /kuradb。setup / update / reconnect 精靈已於 v0.35.0 移除 —— KuraDB 改為自行安裝，並像其他 MCP server 一樣透過 /mcp 註冊。
已無 /voice（v0.34.3 移除）。接收語音的處理不再是開關：它取決於 /model stt 選定的 speech-to-text 模型；而 Telegram 與 Discord 的語音回覆已完全移除 —— 改由 generate_audio 產出檔案。
已無 /sudo。提權模式已於 v0.32.10 改為逐請求授權——受限路徑或 $HOME 之外的寫入，只會為該次呼叫升起一則提示並在該處要求系統密碼。詳見安全模型頁。
已載入的 skill 會以其來源標籤顯示在內建指令下方的同一個選單中；scheduler skill（/sched-<name>）再接在其後。