執行模式與設定檔
執行 catdesk 後的所有行為都由啟動時的選擇與 ~/.catdesk/config.toml 決定。本文整理模式選擇、語言切換、環境變數覆寫，以及 AGENTS.md 的查找規則。
三種執行模式
每次啟動都會出現模式選擇畫面：
| 模式 | 能力 |
|---|---|
| Control Computer | 檔案讀寫與指令執行 |
| Control Browser | 透過 chrome-devtools-mcp 橋接控制瀏覽器 |
| Both | 以上皆是 |
若啟用瀏覽器控制，需再選擇一個支援的 Chromium 瀏覽器。
語言切換
在模式選擇畫面按 l 鍵，可在英文與繁體中文之間切換。偏好會存進 ~/.catdesk/config.toml，下次啟動直接套用。
環境變數
| 變數 | 預設值 | 說明 |
|---|---|---|
PORT |
3200 |
本地 MCP 伺服器監聽埠 |
WORKSPACE_ROOT |
啟動 catdesk 的當前工作目錄 |
工作區 (workspace) 根目錄，檔案工具以此為基準路徑，workspace 之外的路徑會被拒絕 |
覆寫範例：
PORT=4000 WORKSPACE_ROOT=~/projects/my-app catdeskmacOS Terminal.app 專用 Profile
首次在 macOS 的 Terminal.app 啟動時，CatDesk 會詢問是否要使用專用的 CatDesk Terminal profile。若不想被詢問，可設環境變數跳過：
CATDESK_SKIP_MACOS_TERMINAL_PROFILE=1 catdeskconfig.toml 持久化
首次啟動流程中輸入的設定全部寫進 ~/.catdesk/config.toml，包括：
- ngrok authtoken 與 static domain
- 首次啟動時自動產生的隨機 URL 路徑 (random URL path)
- 語言偏好
- 瀏覽器選擇
因為 static domain 與 random path 都會持久化，完整的 MCP URL 在每次啟動之間維持不變，Connector 只需要設定一次。
AGENTS.md 查找順序
每次呼叫 catdesk_instruction 工具時，CatDesk 都會重新依以下順序查找 AGENTS.md：
- Workspace 根目錄
~/.catdesk/AGENTS.md~/.codex/AGENTS.md
找到第一個就使用。也可以在介面中手動指定要用哪一份 AGENTS.md。
每次呼叫都重新檢查，代表你在 session 中途修改 AGENTS.md，下一個工具呼叫就會生效。