What is OzBridge AGENTS.md?

Project instructions for OzBridge, a VS Code extension that connects Copilot Chat with the Oz AI agent command-line tool. They describe the project structure, commands, and development details.

Use them when compiling, testing, watching, bundling, or packaging OzBridge. They also help when working with its npm workspaces and the copilot-chat-toolkit package.

They give an agent the project-specific information needed to build, test, and package the extension correctly. They also point out steps that are easy to miss, such as building a workspace package first.

OzBridge AGENTS.md — Instructions file for Codex and OpenCode by sena-labs: Project instructions for OzBridge, a VS Code extension that…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/sena-labs/ozbridge/agents-md

Clone the repo

git clone --depth 1 https://github.com/sena-labs/OzBridge

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/sena-labs/ozbridge/agents-md.svg)](https://agentmods.dev/instructions/sena-labs/ozbridge/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/sena-labs/ozbridge/agents-md"><img src="https://agentmods.dev/badge/instructions/sena-labs/ozbridge/agents-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 607 This file is loaded in full into every session.

When invoked 607 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00607	$0.00607
Opus 5	$0.00303	$0.00303
Sonnet 5	$0.00121	$0.00121
Haiku 4.5	$0.00061	$0.00061

Measured 3d ago against content hash 04c4bff8861f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

OzBridge AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 31 lines

How it starts

The opening of the file, as written. The whole thing — 31 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

Cursor Cloud specific instructions

Project overview

OzBridge is a VS Code extension (TypeScript, npm workspaces) that bridges VS Code Copilot Chat with Warp Terminal's Oz AI agent CLI. It is a pure extension — no databases, Docker, or external services are needed for development. The workspace package copilot-chat-toolkit (under packages/copilot-chat-toolkit) is a build-time dependency.

Key commands

All standard dev commands are in package.json scripts and documented in README.md and CONTRIBUTING.md. Quick reference:

Task	Command
Type-check (lint)	`npm run compile`
Unit tests	`npm test -- --run` (Vitest, ~13 s)
Build bundle	`npm run build` (esbuild, produces `dist/extension.js`)
Dev watch mode	`npm run watch`
Package VSIX	`npm run package`
Test with coverage	`npm run test:coverage`

Non-obvious caveats

Workspace package build order: The copilot-chat-toolkit package must be built (npm run build --workspace=copilot-chat-toolkit) before npm run build for the main extension if its dist/ directory is missing. After the first build, npm install links it automatically.
Vitest runs serially (fileParallelism: false in vitest.config.ts) because MCP server tests open real TCP sockets; parallel file execution causes port collisions on some platforms. This is intentional and should not be changed.
The vscode module is mocked via vitest.config.ts alias — tests never need a real VS Code instance. The mock lives at test/mocks/vscode.ts.
Bundle budget: The bundle budget is 165 KB for dist/extension.js, enforced in esbuild.js (BUNDLE_MAX_KB) and by the Assert dist/extension.js ≤ 165 KB CI check. Override locally with OZBRIDGE_BUNDLE_MAX_KB. npm run build prints the current size against the budget.
verify-install script (scripts/verify-install.cjs): Loads the bundled extension with a vscode stub and calls activate(). Some assertion failures about activationEvents are expected when run against the current manifest — the script checks for onStartupFinished and per-command activation events that the extension intentionally omits in favor of lazy activation.
E2E tests (npm run test:e2e) require a real VS Code Electron instance and xvfb-run -a on headless Linux. These are not part of the standard CI loop for unit testing.
Test descriptions use Italian language (dovrebbe …) per project convention.

Read the full file on GitHub · 31 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

3d ago First seen · 31 lines · 607 tokens per session scan A 04c4bff8861f

Subscribe to this mod's changes

OzBridge AGENTS.md is an instructions file published in the GitHub repository sena-labs/OzBridge (2 stars, last pushed 6d ago), licensed MIT. It adds 607 tokens to every session, about $0.0030 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

ai-agents claude-code codex copilot copilot-chat cursor

gortex CLAUDE.md

Claude Code instructions for zzet/gortex, covering gortex, build & test, codebase overview, discovery (read once, then keep using) and llm provider (powers ask and searchsymbols assist: modes).

zzet/gortex · 5,172 tokens

mcp-unity AGENTS.md

Instructions for CoderGamester/mcp-unity, covering mcp unity — ai agent guide (mcp package), purpose (what this repo is), how it works (high-level data flow), key defaults & invariants and repo layout (where to change what).

CoderGamester/mcp-unity · 2,498 tokens

rosetta AGENTS.md

AGENTS.md instructions for griddynamics/rosetta: Main goal: cover E2E AI PDLC engineering workflows at foundation level for AI-First SDLC in enterprise. Top-level or orchestrator agents MUST READ docs/ARCHITECTURE.md contains technical details and guidance, and docs/CONTEXT.md - business context. Subagents - when…

griddynamics/rosetta · 270 tokens

OzBridge AGENTS.md