安裝
curl -fsSL https://get.cotal.ai | sh適合誰
Cotal 是一個不綁定特定模型提供商、可跨機器使用、可擴充的開放標準，定位是讓多個 AI agent 協同工作。如果你同時使用 Codex、Cursor、OpenCode、Gemini CLI、Windsurf 中不止一個用戶端，想讓它們共用同一套 Agent Skills；或者經常換機器工作，希望一個中途停下的 workflow 能在另一台主機上接著跑，它就是對口的工具。Claude Code 用戶走的是官方另外提供的 cotal-skills 外掛形態。
如果你只用單一用戶端，也不需要跨機器接續任務，它能帶來的增量有限。以下資訊官方頁面沒有給出，決策前請按未確認處理：支援的作業系統與版本需求、是否需要帳號或金鑰、明確不適合的場景。目前能確認的邊界是：安裝寫入使用者 home 目錄且無需 sudo，這通常意味著類 Unix 終端環境，但官方未明說，Windows 是否可用未確認。
3 分鐘完成第一次嘗試
推薦主路徑只有一條，下面的指令與路徑均來自官方說明。
前提：終端機能執行 curl；本機至少裝有 Codex、Cursor、OpenCode、Gemini CLI、Windsurf 之一（Claude Code 見本節結尾說明）。
第一步，執行官方安裝指令。這裡的確認點要先說清：該指令會把遠端腳本下載後交給 shell 執行，並把內容寫入你的 home 目錄，全程不需要 sudo；接受這一點再按 Enter。
curl -fsSL https://get.cotal.ai | sh
第二步，按官方指引接著執行安裝後的設定指令。它會預置一個預設 persona，並把 Cotal 的 Agent Skills 安裝到 ~/.agents/skills。
cotal setup
第三步，打開任一受支援用戶端，發起一個低風險的唯讀小任務，例如讓 agent 介紹剛安裝的 Agent Skills 裡有哪幾類內容、分別適合什麼場景。你能觀察到的成功訊號：安裝腳本正常結束，設定指令完成 persona 預置與 skills 安裝。至於這些 skills 在個別用戶端介面裡如何呈現、首次對話如何路由，官方頁面未說明。
次要說明：Claude Code 使用官方的 cotal-skills 外掛，安裝細節官方頁面未展開。
使用案例
案例一：多個用戶端共用同一套技能。場景：你同時在用 Cursor 和 Gemini CLI，不想為每個工具分別維護一份技能。做法：完成上述安裝與設定後，在其中一個用戶端裡讓 agent 用剛裝好的 skills 做一件小事，比如讓它概述自己現在具備哪些來自 Cotal 的能力。依據：官方為這五個用戶端提供 Agent Skills，並裝入 ~/.agents/skills。各用戶端如何載入該目錄、內容如何同步，官方頁面未說明，可確認的範圍到此為止。
案例二：換一台機器接續停下來的 workflow。場景：一個 workflow 在筆電上跑到一半退出，你想在桌機上繼續。做法：在新主機完成同樣的安裝後，讓 agent 從 journal 恢復這次 run。依據：官方說明 workflow 執行會把每一步記錄進 journal，停止的 run 可在任意主機上從其 journal 恢復。具體恢復指令與 journal 的存放位置官方頁面未給出，不要自行猜測路徑。
使用邊界
檔案與指令：已確認的寫入點有兩個——安裝腳本寫入 home 目錄（無需 sudo），以及設定指令寫入預設 persona 和 ~/.agents/skills。除此之外，agent 執行時是否讀寫其他檔案、是否執行指令、是否存取網路，官方頁面均未說明，請按未知對待，不要假設這些操作不會發生。
執行環境與用戶端：安裝依賴終端機中的 curl；受支援用戶端以官方名單為準，官方並未寫明僅限這些用戶端，其他用戶端能否使用未確認。
官方限制與未確認項：官方頁面未列出明確的使用限制。尚未確認的關鍵資訊還包括：系統需求、解除安裝方式、具體包含哪些 skills、journal 的存放位置、是否收集資料。使用中遇到這些空白，按未知處理，不要替官方補結論。