用途
Omnigent 是一个开源的 AI 智能体框架与元编排层（meta-harness），用于在 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 以及用户自写智能体之上建立统一的编排层。其目标是让用户无需重写即可替换或组合不同 harness，统一实施策略与沙箱，并支持从任意设备实时协作。
主要能力
- 多设备会话同步：可在终端开始会话，在浏览器继续，再用手机接续；消息、子智能体、终端和文件保持同步。提供本地 Web UI（默认端口 6767）以及 macOS 桌面应用（含系统通知、可配置声音和 Dock 角标）。
- 多智能体监督：可在同一会话中混用 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 和以 YAML 定义的自定义智能体，让一个智能体审查另一个的工作，或将任务拆分给各自擅长的智能体。
- 模型选择：支持自带 API 密钥、Claude/ChatGPT 订阅或任意兼容网关；默认凭证按智能体区分，并可在会话中用 /model 命令切换模型。
- 实时协作：可共享会话，让队友与智能体对话、实时观看工作、在其机器上共同驾驶，或 fork 会话继续独立进行。支持多用户账号，通过环境变量控制；首次运行会输出管理员密码，可通过管理后台生成一次性邀请链接。
- 云沙箱运行：可在 Modal、Daytona、Blaxel、Islo、E2B、Gensee、CoreWeave、Kubernetes、OpenShell、Boxlite、microsandbox、Databricks 等一次性沙箱中运行会话，无需笔记本保持在线；支持由 CLI 启动或由服务器按会话置备（托管主机）。
- 治理与策略：可创建策略，在高风险操作前暂停等待审批、限制花费，或限制智能体可访问的工具；策略可作用于整个服务器、单个智能体或单个聊天。
- 示例智能体：仓库自带示例，如 Polly（多智能体编码协调者，在并行 git worktree 中委派编码子智能体并交叉审查）、Debby（Claude 与 GPT 双头头脑风暴伙伴，支持 /debate 互相批判）、Deep Research（带引用、交叉核验的深度研究智能体，使用 MCP 搜索服务器）。
使用方式
- 安装：一条命令安装 Omnigent 及其依赖。需要 Python 3.12+、uv、git；编程 harness CLI 需要 Node.js 22 LTS 或更新版本与 npm，Web UI 需要 pnpm；原生终端封装需要 tmux；Linux 上需要 bubblewrap（bwrap）进行 OS 沙箱，macOS 使用内置 seatbelt。可用 extras 安装可选集成：模型提供商（databricks、bedrock、vertex），沙箱提供商（modal、daytona、blaxel、boxlite、microsandbox、cwsandbox、e2b、openshell、kubernetes），SDK harness（antigravity、copilot、cursor、agents-sdk），存储与记忆（s3、hindsight）。也可通过 Homebrew 或直接从仓库安装。
- 启动：运行后 Omnigent 会与用户一起选择模型并在终端启动会话，同时启动本地 Web UI。安装后 PATH 上会有 omnigent 和更短的 omni 两个等价命令。可启动特定智能体运行时（如 omnigent agy），或使用浏览器方式：一条命令启动本地服务器并将本机注册为主机，打开打印的服务器 URL，点击 New Chat，选择自己的机器即可。
- 模型配置：添加、设置默认或移除凭证，按智能体分组；默认值按智能体区分，因此 Claude 默认与 Codex 默认可共存。
- 部署服务器：在具有稳定 URL 的服务器上运行后，会话可从任何地方（包括手机）访问；Web UI 为移动端构建。支持 docker compose、Render、Railway 一键部署，以及 Fly.io、Hugging Face Spaces、Modal、Cloudflare（无服务器、缩容至零）、Databricks Apps 等；也可通过 Cloudflare 快速隧道（公开）或 Tailscale（私有）从自己的笔记本访问。在自有网络内可直接用手机打开本机局域网地址。
- 停止与状态：用 omnigent server status 查看状态，omnigent stop 停止一切。
- 升级与卸载：有新版发布时 Omnigent 会显示一行提示（每个版本一次），可用 omni upgrade 更新；卸载可清理 CLI 与安装器管理的 PATH 条目，--purge 可额外移除 ~/.omnigent 状态，--purge-workspace 可移除 ~/omnigent 工作区。
适用场景
适用于需要跨多个编码智能体进行编排与监督的开发者、需要从多设备接入并在团队间共享实时会话的团队，以及需要在云沙箱中运行智能体、对智能体行为施加审批、花费和工具访问策略的组织。也可用于自动化：Automations 页面可按计划定期运行智能体。
限制
- Windows 上以降级模式原生运行：安装引导脚本为 POSIX-only，需用 uv 直接安装。Windows 上可用 omnigent server、Web UI 和基于 SDK 的 harness，智能体运行在 Windows Job Object 下进行进程树隔离；但原生 tmux/PTY 终端封装不可用，bwrap/seatbelt 文件系统与网络沙箱以及 L7 出口代理不可用，Job Object 后端仅包含进程树并强制资源限制，不隔离文件系统或网络。
- Devin CLI 与 Kiro CLI 为可选集成，需单独安装并登录；Devin 工具审批会以 Chat 审批卡出现，Kiro 工具审批在嵌入终端中作答。
- XAI 相关的内置 ACP 行没有自己的 env_passthrough，XAI_API_KEY 不在主机到运行器的凭证允许列表中，直接导出不会到达智能体，需显式传递或配置声明 passthrough 的 acp 智能体。
- omnigent agy 需要 agy 1.1.13 或更新版本；设置 GEMINI_API_KEY 时，直接 Gemini API 认证优先于 agy 保存的 OAuth 登录。
- 标题生成有长度限制：默认生成标题不超过 100 字符，自定义标题要求最多 200 字符，超长会截断；手动指定标题也限制为 200 字符。
- 多用户账号需要环境变量 OMNIGENT_AUTH_ENABLED 启用，Docker 部署默认开启；注册为邀请制，队友需能访问服务器，本地服务器仅在自有网络可达，离网用户需部署常驻主机。
- 部署目标的完整菜单、数据库选项、沙箱设置与品牌/白标相关内容位于 deploy/README.md。
- 收费、价格、具体效果等资料未提供。
