oz_agent_runLABSCO SUMMARY
One agent, reachable from whichever editor you are actually in.
The useful property is that the same six tools are what Copilot sees inside VS Code and what Claude Code or Cursor see over SSE — so switching editors does not mean switching agent setups. Making model selection a tool rather than a settings field is a small thing that matters in practice: the agent can move itself onto a cheaper or stronger model mid-workflow. Keep the local/cloud split in view, since one of those two run tools spends credits and the other does not.
What it is
An MCP server and VS Code extension that exposes Warp's Oz agents to any MCP-compatible client. Inside VS Code, Oz appears as an @oz chat participant and as tools Copilot Agent mode can invoke; outside it, the same toolset is served over HTTP+SSE so other clients drive Oz through it. It is an independent project built on Warp's documented public interfaces — the oz CLI, MCP and an output-format environment variable — and is not affiliated with Warp.
What you get
- An Oz agent run started locally with a prompt, returning the full run payload —
oz_agent_run - A cloud run launched, which consumes Warp credits —
oz_agent_run_cloud - A run's status and output fetched by id, read-only —
oz_run_get - Recent runs listed, filtered by
all,active,completedor a raw status, with a numeric limit —oz_run_list - The model ids available to the account and the current default, read-only —
oz_list_models - The default model set by writing
defaultModelinto the workspace configuration file, validated against the CLI's own model list —oz_set_default_model - Inside VS Code as well: slash commands covering the agent workflow, a sidebar with active runs, history, schedules and environments, and automatic injection of workspace path, active file, selection and diagnostics into every prompt
Requirements
Warp Terminal installed with the oz CLI on PATH, and a Warp account signed in via oz login. The bridge runs either standalone — npx -y @sena-labs/oz-mcp-server — or embedded in VS Code, which needs version 1.96.0 or newer and, to actually invoke @oz, the GitHub Copilot Chat extension. Both listen on http://127.0.0.1:3847/sse by default; setting a bearer token makes clients send an Authorization: Bearer header, and without one you omit the headers block. Published as ozbridge (1.4.0), MIT licensed. Cloud runs consume Warp credits — local runs do not.
Setup effort
One command — npx -y @sena-labs/oz-mcp-server
USE CASES
01
Using Warp's agent from an editor Warp does not ship in
Start the bridge, add the SSE endpoint to Claude Code, Cursor or Codex, and drive Oz through the same tools Copilot uses.
02
Handing a long job to the cloud and checking back
Launch a cloud run, then poll its status and output by id rather than holding the session open.
03
Switching models without editing settings
List the models the account can use and set the default from inside the conversation.
04
Reviewing what the agent has been doing
List recent runs filtered to active or completed and read the outputs of the ones that matter.
6 tools
Listed in project docs. Your client may show a different list.
oz_agent_run_cloudoz_run_getoz_run_listoz_list_modelsoz_set_default_modelBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- npx on PATH
- Warp Terminal installed, with the oz CLI on PATH
- A Warp account, signed in via oz login
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @sena-labs/oz-mcp-serverMCP Clients
Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"oz-bridge": {
"type": "sse",
"url": "http://127.0.0.1:3847/sse",
"headers": {
"Authorization": "Bearer <YOUR_SECRET>"
}
}
}
}~/.claude.json
Cursor
CURSOR · JSON
{
"mcpServers": {
"oz-bridge": {
"url": "http://127.0.0.1:3847/sse",
"headers": {
"Authorization": "Bearer <YOUR_SECRET>"
}
}
}
}~/.cursor/mcp.json
VS Code
VS CODE · TERMINAL
code --install-extension sena-labs.ozbridgeNo MCP wiring needed in VS Code — once the extension is installed, Oz appears as the @oz chat participant and as Language Model Tools that Copilot Agent mode calls on its own.
VSCodium
VSCODIUM · TERMINAL
codium --install-extension sena-labs.ozbridgeInstalls the OzBridge extension from Open VSX — https://open-vsx.org/extension/sena-labs/ozbridge
Gitpod, Theia
Inside the editor, search for "OzBridge" in the Open VSX extensions view and install it — https://open-vsx.org/extension/sena-labs/ozbridge
