mngr

mngr 是什麼？

mngr 是一款類 Unix 的命令列工具，用於管理在各種執行環境中的 AI agent，包括本機、遠端主機，或容器/沙箱內。專案將 mngr 描述為建立、銷毀、列出、複製及連線 agent 的方式，讓你能聊天或除錯，同時保持 agent 基礎設施易存取且可腳本化。

儲存庫將 mngr 定位為「agents 的 git」，強調使用熟悉的原語如 SSH、git 和 tmux 以程式方式管理 agent。它設計為無需託管服務即可執行 agent；你自行操作運算資源，並透過標準機制連線。

主要功能

• 透過 CLI 管理 agent：支援從終端機建立、列出、連線及傳遞訊息給 agent，包括具名 agent 實例。
• 基於 SSH、git 和 tmux 的類 Unix 程序管理：儲存庫表示建基於這些工具，將 agent 生命週期操作與標準基礎設施工作流程對齊。
• 在遠端主機及容器/沙箱中執行 agent：README 強調跨「遠端主機、容器和沙箱」擴展，而非僅限單一本機設定。
• 無需鎖定單一提供者/介面即可組合工作流程：你可在「agent 之上」建構自有工作流程，避免與特定提供者或 UI 緊密耦合。
• 透過外掛擴充：專案提及基於外掛的擴充性。

如何使用 mngr

1. 安裝 mngr：使用提供的腳本 curl -fsSL https://raw.githubusercontent.com/imbue-ai/mngr/main/scripts/install.sh | bash。
2. 建立 agent：例如 mngr create 使用預設在本機啟動 agent（README 範例顯示 agent=claude, provider=local, project=目前目錄）。
3. 在全新遠端主機啟動：例如 mngr create @.modal 在 Modal 上啟動 agent，並自動產生主機名稱（README 描述）。
4. 命名 agent 並選擇啟動 agent：使用 mngr create my-task 和 mngr create my-task codex 以指定名稱執行不同 agent 類型。
5. 連線並傳送初始訊息（選用）：README 提及以 -- --model ... 傳遞底層 agent 參數，並使用 --no-connect --message "..." 提交初始訊息而無需等待。

使用情境

• 本機 agent 開發設定：以 mngr create 從目前目錄啟動 agent，透過一致終端工作流程聊天或除錯。
• 從單一 agent 擴展至跨主機的多 agent：跨遠端主機、容器和沙箱執行「數百個 agent」，使用相同 CLI 列出及連線。
• 複製或快照 agent 狀態：將 agent 設定及狀態視為可複製及管理的物件（README 列出 clone/snapshot/migrate 動作）。
• 提供者無關的工作流程：建構高階工作流程，協調不同 agent 類型及執行位置，而不綁定特定提供者或介面。
• 團隊/共享基礎設施存取模式：使用基於 SSH 的連線及標準工具（tmux、git）管理 agent 程序，融入既有營運實務。

常見問題

mngr 是託管服務嗎？ 不是。README 明確表示「無需託管服務」，描述 mngr 為建基於 SSH、git 和 tmux 的 CLI，適用你控制的運算資源。

agent 可在何處執行？ 依 README，agent 可在本機執行，也可跨遠端主機、容器和沙箱。

如何安裝 mngr？ 儲存庫顯示從 GitHub 管道腳本至 bash 的安裝指令。

可自訂啟動的 agent 或模型嗎？ README 表示可傳遞參數至底層 agent（例如 -- --model opus）並選擇 agent 類型（範例：mngr create my-task codex）。

替代方案

• 通用 SSH 遠端程序管理 + 自訂腳本：可執行 tmux 工作階段並經 SSH 連線，但需自行建構 agent 生命週期、列出及訊息工作流程。
• 其他 agent 協調框架：透過 API/UI 管理 agent 的框架起步較簡單，但可能比 mngr 的「SSH + git + tmux」方式更緊密耦合特定提供者/介面。
• 僅容器工作流程（Docker Compose/Kubernetes jobs）加手動附加：可標準化執行環境，但會失去 mngr 的「agents 的 git」複製/快照概念及其終端優先的 agent 管理介面。
• 無 agent 生命週期管理的 git 工具：可版本化 agent 程式碼及設定，但仍需獨立工具來建立/連線/訊息執行中 agent。