From 1c66fa752e3cc5c03d1e066dd70c885ca2b7740e Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Mon, 27 Jul 2026 17:06:04 +0000 Subject: [PATCH] docs: document named-agent base prompt flag in CLI reference Add the base prompt attribute (`--prompt` / `--remove-prompt`) to the `oz agent create`/`oz agent update` documentation in the Oz CLI reference. Surfaced by the missing_docs drift-watch audit (new CLI flag --remove-prompt in warp_cli/src/agent.rs). Co-Authored-By: Oz --- src/content/docs/reference/cli/index.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index e6844f42..08f92edb 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -396,7 +396,7 @@ The following commands are available for managing and inspecting Oz resources. ### Managing named agents -[Named agents](/platform/agents/) are reusable agent configurations — a name, description, skills, secrets, base model, and default environment — that you can run with `oz agent run-cloud --agent ` and scope API keys to. +[Named agents](/platform/agents/) are reusable agent configurations — a name, description, base prompt, skills, secrets, base model, and default environment — that you can run with `oz agent run-cloud --agent ` and scope API keys to. List the named agents on your team, optionally sorting by name or creation time: @@ -417,6 +417,7 @@ Create a named agent. Only `--name` is required; attach skills and secrets by re oz agent create \ --name "release-notes" \ --description "Drafts release notes from merged PRs" \ + --prompt "Draft concise release notes grouped by feature area." \ --skill "myorg/repo:release-notes" \ --secret GITHUB_TOKEN \ --base-model \ @@ -438,6 +439,7 @@ Common `oz agent update` flags: * `--name ` (`-n`) — rename the agent. * `--description ` / `--remove-description` — set or clear the description. +* `--prompt ` / `--remove-prompt` — set or clear the base prompt applied to the agent's runs. * `--add-secret ` / `--remove-secret ` / `--remove-all-secrets` — manage attached secrets. * `--add-skill ` / `--remove-skill ` / `--remove-all-skills` — manage attached skills. * `--base-model ` / `--remove-base-model` — set or clear the base model.