# CLI 指令

## 頂層分派

`agen` 解析 `os.Args[1]` 並分派到下列子指令之一。不帶子指令時 attach TUI（若無 daemon 執行中則 fork-exec 一個）；stdin 非 TTY 時則改為透過標準輸入輸出提供 MCP JSON-RPC 服務。

```bash
agen                       # Attach TUI；無 daemon 時自動啟動
agen stop                  # 停止執行中的 daemon
agen update                # 下載最新 release 並重新編譯
agen --enable-claude-code  # 啟用 claude-code 供應商並 attach TUI（daemon 須先停止）
agen --daemon              # 直接啟動 daemon
```

以上即為全部介面。其餘輸入會印出 usage 並以 1 結束。單次執行的 `agen cli <input>` / `agen run <input>` 已移除——單次請求現在走 TUI、本機 HTTP API（`POST /v1/send`）或聊天通道。

`agen --enable-claude-code`（v1.1.0）為其啟動的 daemon 開啟 `claude-code` 供應商；daemon 仍在執行時會拒絕啟動，請先執行 `agen stop`。

短暫存在的 `agen startup <enable|disable>` 子指令已移除；開機自動啟動請在 TUI `/config` 的 **Startup on login** 切換。

模型、session 與 MCP 管理位於 TUI（`/model`、`/session`、`/new`、`/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` 後重新接上以載入新版。

## 模式

在 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`；沒有環境變數覆寫。詳見設定檔頁。