CLI 指令
頂層分派
agen 解析 os.Args[1] 並分派到下列子指令之一。不帶子指令時 attach TUI（若無 daemon 執行中則 fork-exec 一個）；stdin 非 TTY 時則改為透過標準輸入輸出提供 MCP JSON-RPC 服務。
agen # Attach TUI；無 daemon 時自動啟動
agen cli <input...> # 單次執行，需逐工具確認
agen run <input...> # 單次執行，該次請求自動核准工具
agen stop # 停止執行中的 daemon
agen update # 下載最新 release 並重新編譯
agen --daemon # 直接啟動 daemon
模型、session 與 MCP 管理已移入 TUI（/model、/switch、/new、/bot、/mcp）與本機 HTTP API——不再有 agen model / agen session / agen mcp 子指令。
agen run
run 只跳過逐次呼叫的確認；沙箱、拒絕路徑、排除清單與 runtime 限制仍然生效。
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 stop # 停止執行中的 daemon
make update # 等同 agen update
make test # 執行全部單元測試
make setup # 交叉編譯 setup binary 到 dist/
make cli <input...> # agen cli <input...>
make run <input...> # agen run <input...>
make build 同時刷新內建 skill 與 tool：extensions/skills/ → ~/.config/agenvoy/skills/.system/，extensions/scripts/ → ~/.config/agenvoy/tools/.system/。
輸入前綴
exec.Run() 內的解析順序：
| 順序 | 前綴 | 效果 |
|---|---|---|
| 1 | :name |
將這一次輸入路由到指定 session，不移動主要指標 |
| 2 | /<skill-name> |
啟動匹配的 skill；其後文字成為其綁定 context |
| 3 | model:<hint> |
讓 dispatcher 路由偏向指定模型；hint 併入路由輸入而非 prompt |
三者可由左至右組合：
make cli ":ship-v0.30 /commit-generate"
make cli "model:claude summarize today's commits"
未知的 :name 會立即失敗並回報 session "<name>" not found。外部 CLI 前綴（/claude、/codex、/gemini、/gh）已隨外部 agent 呼叫工具一併移除。
模式
在 TUI 以 Shift+Tab 切換 auto 模式（[safe] ↔ [auto]）、Shift+F 切換 fast 模式。Auto 模式為 session 區域性設定，TUI 重啟後重置，也可於啟動時以 agen --allow-all 指定。完整快捷鍵與斜線指令清單見 TUI 指南。
設定
Runtime 限制位於 ~/.config/agenvoy/config.json 的 limits；沒有環境變數覆寫。詳見設定檔頁。