oz

Use the Oz REST API and CLI to:

• Spawn cloud agents
• Get the status of a cloud agent
• Schedule cloud agents to run repeatedly
• Create and manage the environments in which cloud agents run
• Provide secrets for cloud agents to use

Command Line

The Oz CLI is installed as oz. To get help output, use oz help or oz help <subcommand>. Prefer --output-format text to review the response, or --output-format json to parse fields with jq. You can find more information at https://docs.warp.dev/platform/cli.

The most important commands are:

• oz agent run-cloud: Spawn a new cloud agent. You can configure the prompt, model, environment, and other settings.
• oz run list and oz run get <run-id>: List all cloud agent runs, and get details about a particular run. This includes the session link to view that session in the cloud.
• oz environment list and oz environment get: List available environments, and get more information about a particular environment.
• oz schedule list and oz schedule get: List scheduled tasks with most recent runs, and get more information about a particular scheduled run.