docs: document named-agent base prompt flag in CLI reference - #387
docs: document named-agent base prompt flag in CLI reference#387hongyi-chen wants to merge 3 commits into
Conversation
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 <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
I'm starting a first review of this pull request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
![oz-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
There was a problem hiding this comment.
Overview
This PR updates the Oz CLI reference to document the named-agent base prompt field across the overview, oz agent create example, and common oz agent update flags. The changes align with the public CLI surface shown in the attached context and do not introduce security-sensitive behavior.
Concerns
- No blocking concerns found.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
1 participant
What
Documents the base prompt attribute of named agents in the Oz CLI reference (
reference/cli/index.mdx):--promptto theoz agent createexample and the named-agent attribute list.--prompt <TEXT>/--remove-promptpair to the "Commonoz agent updateflags" list.Why
Surfaced by the
missing_docsdrift-watch audit. The diff detected a new public CLI flag--remove-promptincrates/warp_cli/src/agent.rs(oz agent update). The base prompt attribute (--prompton create,--prompt/--remove-prompton update) is a GA, public-repo (warpdotdev/warp) surface that was missing from the CLI reference, so this fills that gap.Validation
npm run buildpasses (349 pages built).Deferred findings (from this drift-watch run)
These were triaged but intentionally not addressed in this PR:
/agent/*messaging/events/schedules/artifacts,/factory/*) —warp-serveris private and these are not in the released OpenAPI spec. Route released endpoints through thesync-openapi-specskill; the rest are internal/unreleased. Not hand-documentable.evaluations/evaluations/:evaluationIdOz web app routes +factory/scorersAPI routes — Factory/Evaluations preview surface, not publicly documented yet. Deferred.WellKnownMcpIdsfeature flag — dogfood; snapshot-tracked only, no docs needed until promotion.potentially_stale_docs(LOW terminology) — owned by thestyle_lintskill; many are legitimate ("Warp Terminal" distinguishing from Oz, billing "AI credits").Surface-map (
/theme,appearance.theme→ internal) and snapshot bookkeeping are handled in a separate companion PR.Conversation: https://staging.warp.dev/conversation/5113be3f-fb48-437d-9e4e-59fd0269e2ee
Run: https://oz.staging.warp.dev/runs/019fa484-f76e-7a51-a25b-58112517462a
This PR was generated with Oz.