Skip to content

docs: document cloud agent runners#343

Draft
hongyi-chen wants to merge 1 commit into
mainfrom
oz/docs-runners
Draft

docs: document cloud agent runners#343
hongyi-chen wants to merge 1 commit into
mainfrom
oz/docs-runners

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Summary

Adds a Cloud agent runners doc page documenting a feature that is now GA but had no docs.

Runners are reusable compute configurations for cloud agents (OS, architecture, Docker image, instance size, and setup commands). The feature is GA via the CloudRunners and CloudAgentRunners default cargo features in the public warpdotdev/warp repo.

What this documents

  • The oz runner CLI commands: list, create, update, delete, with all flags.
  • The oz agent run-cloud --runner <ID> flag for selecting a runner per run.
  • Runner selection when launching remote child agents during orchestration.

Files

  • src/content/docs/platform/runners.mdx (new) — added to the sidebar under Platform > Managing agents, next to Environments.
  • src/sidebar.ts — sidebar entry.

Source

  • warp:crates/warp_cli/src/runner.rs (CLI), warp:crates/warp_cli/src/agent.rs (--runner), warp:crates/warp_features/src/lib.rs + warp:app/Cargo.toml (GA flags).

Validation

npm run build passes (348 pages). The missing_docs audit no longer reports the runner CLI/feature findings.

Companion surface-map + snapshot changes ship in the separate audit-bookkeeping PR.

Conversation: https://staging.warp.dev/conversation/1a0de95c-efc7-4af6-941b-bb8c5b9c83c7
Run: https://oz.staging.warp.dev/runs/019f8078-72eb-7187-aba7-cfc11da0d5a4

This PR was generated with Oz.

Add a Runners page under Platform > Managing agents documenting the oz runner
CLI (list/create/update/delete) and the run-cloud --runner flag, now GA via the
CloudRunners and CloudAgentRunners default cargo features.

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Jul 20, 2026
@vercel

vercel Bot commented Jul 20, 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, Comment Jul 20, 2026 5:13pm

Request Review

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.

2 participants