Fast follow 2: refine orchestrate launch docs

[rachaelrenk]

Summary

This PR is a broad fast-follow to the Cloud Agents launch docs, covering the Oz web app, agent identities, harness setup, and authentication guidance.

• Clarify the Oz web app surface for cloud agents, including Quick run, saved agents, schedules, environments, integrations, and how orchestrated parent/child runs appear in the Runs page.
• Tighten the Oz web app Agents section around saved agents as reusable cloud agent configurations, with concise links to deeper Skills as Agents and Agent identities references.
• Refine agent identity documentation with more precise, cross-linked wording for team-scoped identities, editable fields, and deletion behavior.
• Tighten harness and authentication guidance for Warp Agent, Claude Code, and Codex, with supporting screenshots for the harness selector and Claude Code auth secret setup.
• Improve article readability by removing redundant callouts, incomplete detail tables, and extra section dividers from the Oz web app page.

Validation

• git diff --check
• npm run build

Conversation: https://staging.warp.dev/conversation/db4886fb-3576-4fbc-b694-e8f0852e4bb0

Co-Authored-By: Oz oz-agent@warp.dev

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 21, 2026 4:20am

[oz-for-oss]

@rachaelrenk

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 /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[oz-for-oss]

Overview

This PR refines the cloud agent harness documentation for Warp Agent, Claude Code, Codex, and the harness overview, including clearer credential setup language and two new screenshots. I did not find correctness, security, style, or structure issues that need changes before merge.

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

[rachaelrenk]

Pushed a scoped follow-up for the Oz web app launch docs review in afff0fa (Tighten Oz web app docs).

What changed and why:

• Folded orchestrated runs into the Runs section — Moved the parent/child run inspection guidance under ## Runs as ### Inspecting orchestrated runs because this content explains how orchestration appears in the web app’s run-management surface, not a separate top-level product area.
• Removed the “Where to start an orchestration” subsection — Cut the web-app-specific orchestration-starting guidance, including the orchestrate-mode phrasing, because the canonical start flow already lives in the orchestration docs and this page should stay focused on web app orientation.
• Tightened the Agents section around the user goal — Kept the core definition of agents as reusable cloud agent configurations, shortened the skills explanation, and kept a concise mention of the team-scoped identity model so readers understand what saved agents do without re-expanding the full identity model here.
• Removed the Agent details table — Replaced the incomplete list-view table with a sentence explaining that opening an agent shows prompt, skills, harness, model, environment, and secrets. This avoids a mismatch between the table fields and the fuller saved-agent configuration described in the section.
• Updated Quick reference and Runs wording — Changed the Agents row to “saved and suggested agents,” clarified that Runs can cover account and team activity where applicable, and changed search wording from “skill name” to “agent name” to better match the current user-facing model.
• Simplified procedural copy — Removed note callouts that only said which button to click, tightened the new-run explanation to avoid repeating Quick run, shortened the new-agent creation flow, and added punctuation to numbered steps.
• Removed body horizontal dividers — Dropped the repeated --- dividers because they made the article feel fragmented after the scoped edits; headings now carry the structure.

Validation:

• git diff --check passed.
• npm run build passed (334 pages built; existing non-blocking prerender warnings still appear).