安裝
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash適合誰
AgentWorks 的官方定位是原始碼可用(source-available)、面向目標驅動的 AI Agent 平台:給 Agent 定一個目標指標,它持續工作直到達成。如果你已經在用 Claude Code、Codex、Cursor、Pi 或 Muse 這些編碼 agent CLI,它直接跑在這些現有 CLI 上。
它同時是一個 MCP 伺服器:想在 ChatGPT、Claude(Desktop、Code、Cowork)或任意 MCP 用戶端的聊天裡直接查目標、讀報告、發起執行,它就很對口。
需要留意的前提:官方說明的安裝路徑只涵蓋 macOS(裝進 /Applications、清除 macOS 隔離標記、必要時經 Homebrew 安裝 Go),其他作業系統未提及;它也不是開箱即用的託管服務,首次啟動必須自選本機工作區資料夾並設定 AUTH_SECRET。
3 分鐘完成第一次嘗試
前提:一台 macOS 機器和一個終端機,腳本需要時會經 Homebrew 補裝 Go。
在終端機執行官方一行安裝指令:
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash
按 Enter 前先看清副作用:腳本會下載最新 release,把 AgentWorks.app 安裝到 /Applications,安裝 Claude Code 和 Codex 存取工具所用的 MCP bridge(放到 ~/go/bin),清除 macOS 隔離標記,然後啟動應用程式。這是帶本機寫入的安裝動作,不是唯讀操作;對遠端腳本有顧慮,可先在瀏覽器檢視該 URL 的內容。
首次啟動設定:依應用程式提示選擇一個工作區資料夾,並設定 AUTH_SECRET。它用於加密 provider keys;同一個工作區若在多台機器上開啟,每台都必須重複使用相同的值。
做一次低風險的首次呼叫:安裝腳本已為 Claude Code 與 Codex 裝好 MCP bridge,在 Claude Code 裡發起:讓它查目標(check goals)或讀報告(read reports),這是官方描述的讀取類能力,不會觸發執行。成功訊號:Claude Code 能回傳目標狀態或報告內容。其他 MCP 用戶端(如 ChatGPT、Claude Desktop)的接入步驟官方頁面未展示,不在這裡代擬。
使用案例
案例一:在聊天裡查進度、讀報告。情境:你已把某個追指標的目標交給 AgentWorks,想在日常對話裡直接了解進展。做法:在已接入的用戶端裡用自然語言讓它查目標、讀報告(check goals, read reports)。可期待結果:官方明確支援從該聊天檢視目標與讀取報告;具體回傳欄位未列出,以實際輸出為準。
案例二:從聊天裡啟動一次執行。情境:你判斷某個目標需要立刻推進,想留在目前對話裡發起。做法:讓 AgentWorks start runs。可期待結果:執行啟動,並由你已安裝的編碼 agent CLI 承載執行(Claude Code、Codex、Cursor、Pi、Muse)。注意這不是查詢,而是會真實做事的動作——執行會持續工作直到達成指標。發起前確認目標與範圍設定無誤;執行層級的人工確認點官方未說明。
使用邊界
讀寫性質:MCP 暴露的能力既有讀取(查目標、讀報告),也有執行(啟動執行)。啟動執行會讓 agent 持續工作直到達成目標指標,有真實副作用;各工具是否帶唯讀提示官方未標註,不要假設全部唯讀。
憑證與本機資料:首次啟動必須選擇本機工作區資料夾;AUTH_SECRET 用於加密 provider keys,同一工作區在每台機器上必須重複使用相同值。Provider keys 如何設定,官方頁面未展開。
副作用與確認點:安裝腳本寫入 /Applications 與 ~/go/bin、清除 macOS 隔離標記並啟動應用程式;執行啟動後 agent 會持續執行,是否有逐步確認機制未在官方說明中找到。
明確限制與未知:安裝路徑僅見 macOS 描述;平台性質為 source-available(儲存庫標題亦自稱 Open source),授權條款以儲存庫為準;非 macOS 平台支援、MCP 工具完整清單與參數、遠端託管形態、除 AUTH_SECRET 外的認證方式均未說明,使用前建議到官方儲存庫核對。