CLI 指令
頂層分派
agen 解析 os.Args[1] 並分派到下列子指令之一。不帶子指令時 attach TUI（若無 daemon 執行中則 fork-exec 一個）；stdin 非 TTY 時則改為透過標準輸入輸出提供 MCP JSON-RPC 服務。
agen # Attach TUI；無 daemon 時自動啟動
agen stop # 停止執行中的 daemon
agen update # 下載最新 release 並重新編譯
agen --daemon # 直接啟動 daemon
以上即為全部介面。其餘輸入會印出 usage 並以 1 結束。單次執行的 agen cli <input> / agen run <input> 已移除——單次請求現在走 TUI、本機 HTTP API（POST /v1/send）或聊天通道。
短暫存在的 agen startup <enable|disable> 子指令已移除；開機自動啟動請在 TUI /config 的 Startup on login 切換。
模型、session 與 MCP 管理位於 TUI（/model、/sessions、/new、/bot、/mcp）、http://127.0.0.1:17989 的 web 儀表板，以及本機 HTTP API——不再有 agen model / agen session / agen mcp 子指令。
agen stop
對執行中的 daemon 送 SIGTERM，接著清除其 runtime 紀錄。無存活行程時印出 No daemon running. 並以 0 結束；PID 紀錄過期時直接清除而非嘗試 kill。
agen update
一律覆寫式更新到最新 release。下載 https://agenvoy.com/scripts/update.sh 至 /tmp/agenvoy-update-*.sh，以 bash 執行，完成後移除暫存檔（SIGINT / SIGTERM 亦會清理）。執行中的 daemon 仍持有舊 binary inode——請 agen stop 後重新接上以載入新版。
make 捷徑
make build # 編譯並安裝到 /usr/local/bin/agen（需 sudo）
make app # stop + build + attach TUI
make dev # 同 app，但從磁碟提供 page/（AGENVOY_PAGE_DIR）
make stop # 停止執行中的 daemon
make update # 等同 agen update
make test # 執行全部單元測試
make build 會把當前 exact-match 的 git tag 寫進 internal/runtime.CurrentVersion（HEAD 沒有 tag 時為 (dev)）；GET /v1/info/version 可讀回。
make build 同時刷新內建 skill 與 tool：extensions/skills/ → ~/.config/agenvoy/skills/.system/，extensions/scripts/ → ~/.config/agenvoy/tools/.system/。
輸入前綴
exec.Prepare() 只辨識一種前綴：
| 前綴 | 效果 |
|---|---|
/<skill-name> |
啟動匹配的 skill；其後文字成為其綁定 context |
/commit-generate
:self-id 與 model:<hint> 前綴已移除；切換 session 請用 /sessions，指定模型請用 /model 或 POST /v1/send 的 session_id / model 欄位。外部 CLI 前綴（/claude、/codex、/gemini、/gh）已隨外部 agent 呼叫工具一併移除。
模式
在 TUI 以 Shift+Tab 切換 auto 模式（[safe] ↔ [auto]）、Shift+F 切換 fast 模式。Auto 模式為 session 區域性設定，TUI 重啟後重置。POST /v1/send 沒有 allow_all 欄位；auto 模式僅是 TUI 切換。完整快捷鍵與斜線指令清單見 TUI 指南。
設定
Runtime 限制位於 ~/.config/agenvoy/config.json 的 limits；沒有環境變數覆寫。詳見設定檔頁。