安裝
curl -fsSL aimaestro.sh | bash適合誰
- 適合同時使用多個 AI 編碼代理(如 Claude Code、Codex、Grok Build 等)的開發者,想在一個網頁儀表板中統一管理這些代理工作階段,而不是在多個終端機之間切換。
- 適合希望代理具備記憶搜尋、程式碼圖譜查詢、代理間訊息通訊等擴充能力的使用者。
- 使用前提:需要在本機透過一條 shell 指令完成安裝;由於應用本身沒有應用層鑑別機制,必須只在可信網路(如 Tailscale 內網)內使用,連接埠 23000 不能暴露到不可信網路。若你無法保證網路邊界,或不接受這種安全模型,則不適合使用。
- 官方證據未說明支援的作業系統最低需求、代理版本需求,這些資訊目前未知。
3 分鐘完成第一次嘗試
建議的主路徑是官方文件提供的遠端 shell 安裝:
curl -fsSL aimaestro.sh | bash
- 前提:一台可執行 shell 的機器,且處於你可控的可信網路內。
- 安裝:在終端機執行上面的指令。它會執行官方的 remote-install 腳本。注意:這是從網路下載並執行腳本的操作,安裝前請確認你信任該來源。
- 安裝後:啟動後它提供基於 Web 的終端機介面,透過 tmux 管理各 AI 代理工作階段(xterm.js 終端機 + node-pty + WebSocket 串流輸出)。
- 第一次嘗試建議選一個低風險任務:在儀表板中開啟一個既有的代理工作階段,讓它做一次唯讀分析,例如總結某個程式碼檔案的結構。具體某個代理支援哪些任務取決於該代理本身,官方證據未列明。
- 成功訊號:在瀏覽器中能看到該代理的終端機工作階段即時輸出,並且代理給出分析結果。儀表板能同時顯示多個代理工作階段也代表編排生效。
官方還提到可以從一個儀表板管理多個代理,但未說明其他安裝方式,本指南只保留上述這一條官方路徑。
使用案例
案例一:統一查看多個代理工作階段。 情境:你同時在跑 Claude Code 和另一個代理,想在同一介面查看它們。 做法:安裝並啟動後,在瀏覽器開啟儀表板,把要管理的代理工作階段接入(官方說明它透過 tmux 管理工作階段)。可期待的結果:在一個 Web 介面中透過 xterm.js 終端機看到各工作階段的即時輸出。
案例二:讓代理做一次唯讀程式碼分析。 情境:想驗證編排環境可用,同時不想讓代理改動任何檔案。 做法:在儀表板中向某個代理下達指令,例如「分析 src 目錄下一個檔案的結構並總結」。會使用的能力:儀表板的終端機工作階段本身;至於是否呼叫記憶搜尋或程式碼圖譜查詢,取決於該代理載入的技能,官方證據未說明預設載入情況。可期待的結果:代理在終端機中輸出分析文字;若沒有檔案修改類操作,屬於可復原的觀察型任務。
使用邊界
- 網路:應用預設綁定 0.0.0.0 且無應用層鑑別機制,安全模型是「網路即信任邊界」,官方要求搭配 Tailscale 等網路邊界使用,連接埠 23000 不得暴露到不可信網路。
- 副作用與確認點:安裝會執行遠端腳本;代理工作階段可能執行指令或存取檔案,具體行為取決於所接入的代理,官方證據未說明本應用對代理操作的額外限制,未知資訊不得當作「無風險」。
- 執行環境:需要 tmux 與支援 WebSocket 的瀏覽器;官方證據未列明作業系統需求。
- 官方明確限制:無應用級鑑別機制是設計決定,不是可設定選項的證據。
- 尚未確認:支援的文字/代理語言範圍、支援的用戶端完整清單、升級與解除安裝方式,官方證據均未說明。