omnigent

需要可选集成吗？向安装程序传递一个或多个附加功能：

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --extra modal,e2b

Antigravity SDK 附加功能与 Databricks 依赖项冲突。使用 --no-databricks --extra antigravity 安装它。

可用的面向用户的附加功能包括：

• 模型提供商：databricks（默认包含），bedrock，vertex
• 沙箱提供商：modal，daytona，blaxel，boxlite，microsandbox，cwsandbox，e2b，openshell，kubernetes
• SDK 工具：反重力，副驾驶，光标，agents-sdk
• 存储和内存：s3，hindsight

Omnigent 需要 Python 3.12 。安装 omnigent 包：

uv 工具安装 omnigent        # 或: pip install "omnigent"

手动安装使用相同的额外语法，例如：

uv 工具安装 "omnigent[databricks,modal]"

或者使用 Homebrew：

brew 安装 omnigent-ai/tap/omnigent

对于需要包镜像的网络上的源码构建，请将这些示例 URL 替换为您的镜像：

HOMEBREW_PIP_INDEX_URL='https://pypi.example.com/simple' \
HOMEBREW_CARGO_INDEX_URL='https://cargo.example.com/index/' \
  brew install --build-from-source omnigent-ai/tap/omnigent

PyPI 设置也将 pip 的隔离构建依赖通过镜像路由。Cargo 设置使用以 / 结尾的稀疏注册表索引 URL，而不带 sparse 前缀。两个覆盖都是可选的，并且不会影响预构建的二进制瓶安装。

或者直接从仓库安装：

uv 工具安装 -q --python 3.12 git  https://github.com/omnigent-ai/omnigent.git

• uv（必需）。https://docs.astral.sh/uv/getting-started/installation/ 安装程序会为你设置这个。
• git（必需）。
• Node.js 22 LTS 或更新版本，带有 npm（用于由 omnigent run 安装的 coding-harness CLI）和 pnpm（用于 Web 界面）。你可以通过一次 Node 安装获取两者；pnpm 可通过 corepack enable 或 npm install -g pnpm 获取。
• Devin CLI（可选），用于 omnigent devin：通过 curl -fsSL https://cli.devin.ai/install.sh | bash 安装，然后使用 devin auth login 登录。Devin 工具的审批将显示为聊天审批卡（其 PermissionRequest 钩子会镜像到网页界面），并且可以在嵌入的终端中答复。请参阅 docs/devin-native.md。
• Kiro CLI（可选），用于 omnigent kiro：使用 curl -fsSL https://cli.kiro.dev/install | bash 安装，然后使用 Kiro 登录。Kiro 工具的审批仍可在嵌入的终端中处理；支持的一次性审批也会以聊天卡片形式显示。请参见 docs/kiro-native-elicitation.md。
• tmux，由原生的 omnigent <harness> 终端包装器（claude、codex、cursor、devin、hermes、kiro、pi）所需（brew install tmux / apt install tmux；安装程序会提供为您安装它的选项）。
• bubblewrap（bwrap），仅限 Linux。原生的 omnigent <harness> 终端封装器和 pi harness 会将每个代理终端封装在 bwrap 操作系统沙箱中；在 Linux 上这种隔离是强制的，因此缺少 bwrap 可执行文件会导致这些终端无法启动（apt install bubblewrap；安装程序会提供为你安装的选项）。macOS 使用内置的 seatbelt 沙箱，不需要额外操作。
• Databricks。 引导安装程序包含 databricks 额外组件和 Databricks CLI。如果直接使用 uv 安装，请使用 uv tool install "omnigent[databricks]" 并单独安装 Databricks CLI。使用 omnigent login <workspace-url>/omnigent 登录到工作区托管的服务器。

Omnigent 可以在 Windows 上以降级模式本地运行。install_oss.sh 引导程序仅支持 POSIX，因此请直接使用 uv 安装：

uv 工具安装 --python 3.12 omnigent

# 或者从仓库：
uv 工具安装 --python 3.12 git https://github.com/omnigent-ai/omnigent.git

在 Windows 上可用的功能：omnigent server、Web 用户界面以及基于 SDK 的测试工具 (omnigent run <agent.yaml> 与 claude-sdk / cursor / codex 测试工具)。代理在 Windows 作业对象 下运行，以实现进程树隔离。

在 Windows 上 不可用（请使用 Linux/macOS 或 WSL 来使用这些）：

• 本地 omnigent claude / omnigent codex / omnigent cursor tmux/PTY 终端封装（请改为运行 SDK 测试环境或 Web 用户界面）；
• bwrap / 安全带 文件系统 & 网络沙箱和 L7 出口代理——作业对象后端包含进程树并执行资源限制，但 不 隔离文件系统或网络。

当 PyPI 上有新版本发布时，Omnigent 会显示一行通知（每个版本显示一次），指向此处。要更新：

全能升级            # 检测你如何安装，消耗  &  停止本地
                        # 服务器，然后运行匹配的升级命令
omni upgrade --check    # 仅报告是否有新版本可用

omni upgrade 会在停止本地服务器之前等待正在进行的代理会话完成（传递 --force 可立即停止它们）；下一次 omni 命令会在新版本上重新启动服务器。源代码检出则改用 git pull 更新。使用 OMNIGENT_NO_UPDATE_CHECK=1 可静默提示。

该检查会查询你配置的包索引——会遵循 UV_INDEX_URL / PIP_INDEX_URL 以及你的 uv.toml / pip.conf（默认 PyPI），因此私有镜像可以开箱即用；如有需要，可使用 OMNIGENT_INDEX_URL 覆盖。

预览默认情况下将运行的 CLI/配置清理：

omnigent 卸载

在保留本地历史记录、凭证和项目的同时，移除 CLI 和安装程序管理的 PATH 条目：

omnigent 卸载 --yes

要同时删除 ~/.omnigent 下的 Omnigent 状态，请使用 --purge；Omnigent 会在删除前将其备份到目标之外。除非你明确添加 --purge-workspace，否则你的 ~/omnigent 工作区将被保留。

omnigent 卸载 --清除 --是

如果已安装的 wheel 损坏或 omnigent 不在 PATH 中，请改为运行独立脚本：

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/uninstall_oss.sh | sh

在独立脚本中添加 --yes 以执行预览的 CLI 清理。

另外两个编码代理已内置，但没有自己的 omnigent <name> 启动器，因为每个代理都自带一个保存其自身登录信息的 CLI。安装供应商 CLI，用它登录，然后命名这个框架：

# Grok 构建 (xAI)
curl -fsSL https://x.ai/cli/install.sh | bash grok login --device-auth              # xAI OAuth 无所不在运行 --harness grok           # 'grok-build' 也可用

# 德文（认知）
curl -fsSL https://cli.devin.ai/install.sh | bash
devin auth login
omnigent run --harness devin

两者都通过 stdio 讲 Agent Client Protocol，并且 Omnigent 不存储任何凭证——每个 CLI 都会读取它写入磁盘的登录信息。这也意味着 --model 会被拒绝而不是静默丢弃：两者都运行其账户默认模型。要固定某个模型，请配置一个 acp: 代理，其命令传递供应商自己的模型标志。

请使用供应商登录而不是 API 密钥。内置的 ACP 行没有自己的 env_passthrough，并且 XAI_API_KEY 不在主机到执行器的凭证允许列表中，因此在你的 shell 中导出它不会传递到代理。如果你需要使用密钥方式，请通过 OMNIGENT_RUNNER_ENV_PASSTHROUGH=XAI_API_KEY 明确传递，或者配置一个声明了 passthrough 的 acp: 代理。

为独立标题生成器设定额外的自然语言要求：

omnigent config set --global \
  'session_title_instructions=在标题前加上当前日期，格式为小写的 mon-dd。对于 pull request 使用 PR-编号-简短名称，对于 issue 使用 issue-编号-简短描述，其他情况使用简短的 snake_case 活动名称。'
标题生成器接收当前日期，格式为 YYYY-MM-DD，然后将这些要求应用于用户的第一条消息。该设置由服务器拥有，并不会修改代理的可移植指令。默认生成的标题限制为 100 个字符；自定义标题要求最多可使用 200 个字符。超过 100 个字符的默认标题会被拒绝，保留第一条消息的回退标题。超过 200 个字符的自定义标题会被截断，并添加省略号。手动分配的标题同样限制为 200 个字符。该设置在本地 Omnigent 服务器重启后生效，适用于新会话以及通过 sys_session_rename 进行的后续代理重命名。代理建议的标题使用相同的标题要求进行格式化；如果格式化失败，将保留现有标题。手动重命名保持不变。对于较长的指令，请直接编辑 ~/.omnigent/config.yaml 并使用 YAML 块标量：
session_title_instructions: |
  在每个标题前加上当前日期，格式为小写的月-日。
  对于拉取请求，请使用 mon-dd-PR-编号-简短名称。
  对于问题，请使用 mon-dd-issue-number-short-description。
  对于其他工作，请使用 mon-dd-short_snake_case_activity。
服务器操作员可以在传递给 omnigent server --config 的 YAML 中设置相同的键。
Claude Code 会话使用 haiku 模型别名生成标题。如果该模型回复消息而不是返回标题，请在运行会话的 omnigent 或 omnigent host 进程的环境中，将 OMNIGENT_BACKGROUND_TITLE_CLAUDE_MODEL 设置为另一个 Claude 模型别名，例如 sonnet。