oz0 plugin new
Create a plugin from a template.
For: Operators and developers looking up a command.
Create a plugin from a template.
Every template writes AGENTS.md, with the manifest's rules and the commands to lint, test, run in dev and pack the plugin, a Claude Code skill (.claude/skills/oz0-plugin) that runs them, a README.md with the sections the hub's page shows (what the plugin does, how to set it up, its limits and where to read more), and a LICENSE placeholder: the plugin has no licence until you put a licence's text there and declare it as license: in oz0-plugin.yaml, and lint warns until then.
Tool IDs and agent names start with the plugin's name.
Templates:
- byo-agent (your own agent code, a script, LangGraph or CrewAI, behind the harness protocol, in Python)
- flow-tool (a fixed procedure as a flow, offered to an agent as one flow tool, over an MCP tool in Python)
- harness-adk (an agent on Google ADK (google-adk) behind the harness protocol, in Python)
- harness-agent-framework (an agent on Microsoft Agent Framework (agent-framework-core) behind the harness protocol, in Python)
- harness-strands (an agent on AWS Strands (the strands-agents SDK) behind the harness protocol, in Python)
- mcp-connector (a connector that wraps a vendor's own remote MCP server, on the customer's own OAuth app)
- procedure (an agent that follows a written procedure a named expert approves)
- python-agent (an agent on Pydantic AI with an MCP tool in Python)
- python-tool (an MCP tool in Python, with the official MCP SDK)
- quarantine-dual-model (the dual-model pattern on oz.quarantine - a privileged agent that acts, a quarantined one that reads)
- quarantine-map-reduce (LLM map-reduce on oz.quarantine - one quarantine child per untrusted document, a typed reduce)
- ts-tool (an MCP tool in TypeScript, with the official MCP SDK, run by the node's Node.js 24).
Usage
oz0 plugin new <dir> [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--description | string | one line about what the plugin does | |
--name | string | the directory's name | plugin name |
--template | string | python-tool | template: byo-agent, flow-tool, harness-adk, harness-agent-framework, harness-strands, mcp-connector, procedure, python-agent, python-tool, quarantine-dual-model, quarantine-map-reduce, ts-tool |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--context | string | $OZ0_CONTEXT or <config dir>/orchestrator-zero/context.json | CLI context file written by server init |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0 commands and the global flags.