Skip to content

docs(cli): document run-cloud --title and --parent-run-id - #602

Draft
hongyi-chen wants to merge 1 commit into
mainfrom
docs/run-cloud-title-parent-run-id
Draft

docs(cli): document run-cloud --title and --parent-run-id#602
hongyi-chen wants to merge 1 commit into
mainfrom
docs/run-cloud-title-parent-run-id

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Summary

oz agent run-cloud gained two flags that the CLI reference didn't cover: --title and --parent-run-id.

Found by the missing_docs drift-watch audit (cli_flag_added surface changes in warp_cli/src/agent.rs).

Changes

  • Added both flags to the run-cloud Key flags list.
  • Titling runs — what --title sets, an example, and how it differs from --name (config name for grouping versus a human-readable label for one run).
  • Starting a run as an orchestration child — what --parent-run-id does to lineage and scope, with an example.

Verification

  • Flag names, value names, and semantics from the RunCloudArgs definitions in crates/warp_cli/src/agent.rs. Neither flag is feature-gated.
  • npm run build passes; style_lint --changed reports no new issues (the web app name uses {VARS.WEB_APP}).

Deferred findings from this audit run

  • 44 Factory REST endpoints absent from the released OpenAPI spec are mapped internal in the companion bookkeeping PR rather than hand-documented, per the skill's public/private guardrail.
  • 30 low-severity terminology/staleness findings are owned by the style_lint skill.

Both flags are new on `oz agent run-cloud`: `--title` sets the run and
conversation title, and `--parent-run-id` starts the run as an
orchestration child of an existing run.

Co-Authored-By: Warp <agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Aug 21, 2026
@vercel

vercel Bot commented Aug 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 21, 2026 5:20pm

Request Review

Copy link
Copy Markdown
Collaborator Author

This PR was generated with Warp.

Comment @warp-agent on this PR to send it follow-up work.

@warp-factories

Copy link
Copy Markdown
Contributor

Your GitHub account is not connected to Warp. Connect it here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant