OzBridge 是一个开源项目，提供 Warp Oz 编码智能体与各类 IDE 或 MCP 客户端之间的非官方桥接。它包含一个 Model Context Protocol（MCP）服务器和 VS Code 扩展，使 GitHub Copilot Chat、Claude Code、Cursor 和 Codex CLI 等 MCP 兼容客户端能够运行 Warp Oz 云端和本地智能体。该项目声明为独立项目，未与 Warp 公司关联、认可或赞助；Warp 和 Oz 是 Warp 公司的商标，此处仅用于描述互操作性。OzBridge 仅使用 Warp 公开的接口（oz CLI、Model Context Protocol 以及 WARP_OUTPUT_FORMAT 环境变量），不修改、不逆向工程、也不与 Warp 竞争。
用途方面，OzBridge 用于在任意 IDE 或 MCP 客户端中驱动 Warp Oz 智能体。它可以在 VS Code 中以嵌入式方式运行，使 Oz 以 @oz Chat Participant 和 Agent-Native Language Model Tools 的形式出现，Copilot Agent 模式可自主调用；也可以通过 HTTP+SSE 暴露同一套 Oz 工具集，让 Claude Code、Cursor 和 Codex 调用。若不使用编辑器，可单独运行 @sena-labs/oz-mcp-server 包，将任意 MCP 客户端指向它。
主要能力包括：MCP 桥接，将 Oz 工具集以 HTTP+SSE 形式暴露给任意 MCP 客户端，可嵌入式运行或完全独立运行。@oz Chat Participant，在 VS Code 聊天面板中与 Warp Oz 智能体交互。Agent-Native Language Model Tools，Copilot Agent 模式可直接调用 Warp Oz，无需输入 @oz。一键模型选择，可通过 QuickPick（OzBridge: Select Model）、状态栏指示器或 @oz /models <id> 选择 Oz 模型；智能体可通过 MCP 工具 oz_list_models / oz_set_default_model 切换。侧边栏与状态栏，活动栏视图包含 Active Runs、History、Schedules、Environments、MCP Servers 与 Secrets，以及活动运行和模型指示器。上下文变量与 Warp 交接，可将 #warp.env、#warp.profile、#warp.model、#oz.history 和 #oz.run/<id> 等内联标记展开到 /run 或 /cloud 提示中，并支持一键交接至真实 Warp 终端。按工作区配置，可选 .warp/warp-bridge.yaml 提交到仓库，覆盖 ozBridge.* 设置，优先级为 YAML > VS Code 设置 > 默认值，但 mcpBearerToken 和平台相关的 ozPath 被有意排除。9 个斜杠命令覆盖完整智能体工作流：/run、/cloud、/status、/history、/schedule、/models、/mcp、/config、/init。IDE 上下文注入，自动在每次提示中包含工作区路径、活动文件、选区和诊断信息。智能体技能检测，将提示关键词映射到 7 智能体流水线（spec、design、implement、review、test、deploy、maintenance）。云运行轮询，采用指数退避轮询并在聊天流中实时更新进度。稳健 JSON 解析器，对混合文本/JSON CLI 输出提供 5 级回退。可配置，所有设置通过 VS Code 设置 UI 的 ozBridge.* 暴露。运行时占用小，仅捆绑一个工作区包（copilot-chat-toolkit）加 vscode API，无第三方网络代码，生产包约 160 KB。
使用方式方面，从注册表安装：自 v0.9.0 起，每次打标签发布都会同步到两个注册表。VS Code Marketplace 链接为 https://marketplace.visualstudio.com/items?itemName=sena-labs.ozbridge，Open VSX 链接为 https://open-vsx.org/extension/sena-labs/ozbridge。也可从 VSIX 本地安装：VS Code GUI 中按 Ctrl+Shift+P 或 Cmd+Shift+P，输入 "Extensions: Install from VSIX…" 并选择 ozbridge.vsix 文件；或使用 CLI。安装后在 VS Code 中按 F5 启动扩展开发宿主。安装验证：打开 Copilot Chat 面板（Ctrl+Shift+I / Cmd+Shift+I），输入 @oz /config 并提交，面板应显示当前配置和检测到的 Oz CLI 路径表格；若 CLI 缺失会显示 "Install Warp" 操作按钮。连接 MCP 客户端：先启动桥接，可在 VS Code 中启用内嵌服务器（"ozBridge.mcpEnabled": true，然后 OzBridge MCP: Start），或运行独立包。两者默认监听 http://127.0.0.1:3847/sse。设置 ozBridge.mcpBearerToken 可要求 Authorization: Bearer <token> 头。客户端配置示例包括添加到 ~/.claude.json、~/.cursor/mcp.json、~/.codex/config.toml。VS Code 无需 MCP 配置，安装扩展后即可通过 @oz 聊天参与者和 Copilot Agent 模式可调用的 Language Model Tools 使用。协议细节、端点参考和 curl 速查在 docs/MCP.md。
适用场景与限制方面，适用于 macOS、Linux、Windows，需 VS Code ≥ 1.101.0（@oz 参与者需要稳定 Chat Participant API；LM Tools 还需 vscode.lm.registerTool），Warp Terminal 已安装且 oz CLI 在 PATH 中，Warp 账户已通过 oz login 登录，GitHub Copilot Chat 扩展为可选但实际调用 @oz 或使用 Agent 模式工具时需要。本地运行在工作区中启动 oz CLI，不消耗 Warp 积分，可完全访问文件；云运行在 Warp 基础设施上执行，消耗积分，并脱离本机运行。免费 Warp 账户足以进行本地智能体运行，云运行可能根据用量需要付费计划。可设置 ozBridge.defaultModel 或通过 /run --model gpt-4o 内联指定模型，使用 /models 查看所有可用模型。默认超时为 300000 毫秒（5 分钟），大规模运行可提高至 600000 毫秒；云运行由 cloudPollingTimeoutMs 单独控制更长超时。扩展仅在 Copilot Chat 中调用 @oz 参与者或 Copilot Agent 模式调用 LM Tools 时激活。测试方面有 100+ 文件中的 1400+ 测试，框架为 Vitest v4.0.18。贡献流程包括 fork 仓库、创建特性分支、提交更改、推送分支、打开 Pull Request，提交前确保所有测试通过，另见行为准则和安全政策。许可证未在资料中提供。
