TUI 指南
單一 bubbletea textarea（internal/runtime/tui）；斜線指令開啟短暫 popup，關閉後乾淨回到輸入提示。
快捷鍵
| 按鍵 | 動作 |
|---|---|
Enter |
送出當前輸入。若有執行中的任務，改為將文字排入 steer 佇列，遞送給執行中的迴圈 |
Alt+Enter |
插入換行 |
/ |
開始斜線指令過濾（popup 選單——Up / Down 移動、Tab / Enter 補進 textarea、Esc 關閉） |
Up / Down |
游標位於第一行 / 最後一行時瀏覽輸入歷史（per-session input_history 檔） |
Esc |
關閉當前 popup；執行中時則開啟取消確認 popup |
Ctrl+C |
離開 TUI（daemon 持續執行） |
單鍵切換僅在輸入為空且無執行中任務時生效：
| 按鍵 | 動作 |
|---|---|
Shift+Tab |
切換 auto 模式（[safe] ↔ [auto]） |
Shift+F |
切換 fast 模式——啟用時標題列顯示 [fast] |
Shift+T |
切換指令模式（輸入內容當作 shell 指令在當前 workDir 執行） |
Shift+U |
即時供應商用量 / 餘額 |
Shift+M |
列出已設定的模型 |
Shift+W / Shift+S |
向前 / 向後輪替 dispatcher 模型 |
Shift+A / Shift+D |
調降 / 調升 reasoning 等級 |
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 重啟後重置；也可於啟動時以 agen --allow-all 指定。Fast 模式為行程區域性，不會寫入 config.json。
斜線指令
| 指令 | 說明 |
|---|---|
/model |
新增 / 移除供應商 · 選擇 session、dispatcher 或 summary 模型 |
/mcp |
新增 / 移除 / 重連 MCP server · 全域或 session 範圍 |
/switch |
以選單切換當前 session |
/new |
建立 session（檢查名稱衝突） |
/dangerous |
remove-session · allow-skill（將 skill 標為 always-allow）· allow-cmd（將 binary 追加到指令允許清單） |
/memory |
compact · reset · summary —— 管理 session 記憶 |
/bot |
編輯 / 改名當前 session —— 名稱與描述（人格） |
/discord |
啟用 / 停用 Discord bot（啟用時驗證 gateway） |
/telegram |
啟用 / 停用 Telegram bot（啟用時以 getMe 驗證） |
/voice |
啟用 / 停用語音訊息處理（Gemini TTS） |
/kuradb |
啟用 / 停用 / 更新 / 啟動 / 停止 KuraDB RAG |
/admin-channel |
設定 / 清除新聊天驗證碼的轉發對象 —— 選擇已授權聊天或 tg@<id> / dc@<id> |
/cron |
新增 / 移除 / 編輯週期性排程任務 |
/task |
新增 / 移除 / 編輯一次性排程任務 |
/sched-<name> |
手動觸發既有 scheduler skill 內容。依 session 過濾——只顯示綁定於當前 session task / cron 項目的 skill |
/update |
取得最新 release、重新編譯並離開 TUI（以 agen 重新接上） |
/resume |
重新載入可見對話——action.log 的最後 100 筆 |
/log |
以 $PAGER（回退 less）開啟原始 action.log |
/usage |
各模型 token 用量 —— 24 小時 / 7 天 / 28 天 |
/pending |
列出 / 續跑中斷的任務 —— 錯誤復原與 ask_user 續跑 |
/sudo |
啟用 / 停用提權模式 —— 繞過指令允許清單，1 小時後自動失效 |
/key |
從已記錄的 key 清單挑選並更新 / 輪替 keychain 值 |
/clear |
清除可見對話 —— 不動記憶 |
/exit |
離開 TUI（daemon 持續執行） |
已載入的 skill 會以其來源標籤顯示在內建指令下方的同一個選單中；scheduler skill（/sched-<name>）再接在其後。