oz0 agent new
For: Operators and developers looking up a command.
Write <name>.md in the current folder (or --dir): an agent in one file, its fields in the front matter and its instructions below, with apiVersion: oz0/v1, a description to fill in and the default model alias. It never writes a manifest, and never overwrites a file.
The file is a plugin of that one agent: dev <name>.md reloads it on every save on a dev server, run <name>.md [INPUT] runs it once on a dev server of its own, and plugin install ./<name>.md installs it in your cluster's tenant (on a terminal it shows what the agent needs, may do and reaches, and asks once, which also grants what it uses of other plugins), after which run <name> runs it.
The plugin's name and version come from the file: its name, and the digest of what was uploaded (or the tag or commit of a Git source).
--uses <plugin> lists that plugin's functions by address, <plugin>/<tool>.<function>, from the tenant's catalog when your CLI context's server answers: the Read ones on, the others written commented out with their type, to take the # out of the ones the agent needs. --tool <address> lists exactly that function instead. Without a server it writes a commented example to fill in. Each function listed is granted at install, and the tenant's tool policy still decides each call.
Usage
oz0 agent new <name> [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--description | string | a line to fill in | what the agent does, in one line |
--dir | string | the current folder | the folder to write <name>.md in |
--runtime | string | the agent's runtime when it is not pydantic-ai: openai-agents, harness:<name> or remote:<name> | |
--tenant | string | default | the tenant whose catalog --uses reads |
--tool | stringArray | one function the agent calls, by address, <plugin>/<tool>.<function>; repeatable | |
--uses | stringArray | a plugin whose functions the agent calls, listed by address from the tenant's catalog; repeatable |
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.