Rename 'Oz agent' to 'agent' / 'Warp Agent' across docs by rachaelrenk · Pull Request #68 · warpdotdev/docs

rachaelrenk · 2026-05-12T16:54:39Z

Summary

Renames "Oz agent" terminology throughout the docs to align with the new product naming:

"Oz agent" / "Oz agents" → "agent" / "agents" (generic) or "Warp Agent" (when specifically referring to the built-in Warp harness)
"Oz cloud agent" → "cloud agent"
"Oz subagent" → "subagent"
"Oz conversation" → "conversation"
Oz platform terms (Oz CLI, Oz web app, Oz run, Oz Platform, Oz API, Oz SDK) are kept as-is

Scope

74 files changed across three workstreams:

Source-of-truth files (19 files): AGENTS.md, terminology glossary, style guidelines, linter rules, templates, CI workflows, API spec
Agent-platform content docs (29 files): Core agent docs with highest density of changes
Other docs (26 files): Enterprise, reference, support, terminal, changelog

Decision rules applied

"Warp Agent" is used when specifically describing the built-in Warp-harness agent (e.g., contrasting with Claude Code, Codex) or referencing the Settings label
"agent" (generic) is used everywhere else — this covers the vast majority of former "Oz agent" instances
CLI commands (oz agent run, oz agent run-cloud) are kept as-is since they are literal command names
Changelog 2026 is updated; older changelogs are left as historical records

Oz conversation | Plan

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

Rename 'Oz agent(s)' to 'agent(s)' or 'Warp's built-in agent(s)' across enterprise, reference, support, terminal, and other docs. Rename 'Oz cloud agent(s)' to 'cloud agent(s)' and 'Oz conversation' to 'conversation'. Rename 'Oz Agent SDK' to 'Oz SDK'. Preserves all Oz platform terms (Oz CLI, Oz web app, Oz run, Oz dashboard, Oz Platform, Oz Open Source Partnership) and CLI command references (oz agent run, oz agent run-cloud, etc.) as-is. Files updated: 26 files across enterprise/, reference/, support-and-community/, terminal/, knowledge-and-collaboration/, guides/, changelog/2026.mdx, quickstart.mdx, and index.mdx. Co-Authored-By: Oz <oz-agent@warp.dev>

…iles Update terminology references, style guidelines, AGENTS.md, linter rules, templates, CI workflows, and API specs to reflect the new naming: - 'Oz agent' -> 'agent' (generic) or 'Warp Agent' (built-in harness) - 'Oz cloud agent' -> 'cloud agent' - 'Oz subagent' -> 'subagent' - Oz platform terms (Oz CLI, Oz web app, Oz run, etc.) kept as-is Co-Authored-By: Oz <oz-agent@warp.dev>

Update all agent-platform docs to reflect the new naming: - 'Oz agent' -> 'agent' (generic) or 'Warp Agent' (built-in harness) - 'Oz cloud agent' / 'Oz Cloud Agent' -> 'cloud agent' / 'Cloud Agent' - 'Oz subagent' -> 'subagent' - Oz platform terms (Oz CLI, Oz web app, Oz run, etc.) kept as-is Co-Authored-By: Oz <oz-agent@warp.dev>

…-oz-agent-to-warp-agent

…-agent-to-warp-agent

vercel · 2026-05-12T16:54:44Z

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

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 17, 2026 10:52pm

oz-for-oss · 2026-05-12T16:54:53Z

@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 updates the docs terminology from "Oz agent" toward generic "agent" / "Warp Agent" naming and adjusts related style/lint references.

Concerns

The new style-lint rule for Oz agents? is case-insensitive, so it will also match valid lowercase oz agent ... CLI commands that this rename intends to preserve.

Verdict

Found: 0 critical, 1 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

- Resolve conflict: keep our 'agent credits' rename + main's LICENSE-AGPL link fix - Fix check_oz_terms to properly skip fenced code blocks and strip inline code spans, so CLI commands like `oz agent run` are not falsely flagged Co-Authored-By: Oz <oz-agent@warp.dev>

hongyi-chen

looks good! we should set up this skill to run once a week in case we miss any of these with this rename + to keep future changes standardized

hongyi-chen · 2026-05-12T21:55:41Z

 ## Agent concepts

- **Ambient Agents** — Oz agents that run automatically in the background on a schedule or trigger, without interactive input.
+- **Ambient Agents** — Agents that run automatically in the background on a schedule or trigger, without interactive input.


we should change this to something closer to oz cloud agents

hongyi-chen · 2026-05-12T21:56:08Z

 - **Oz dashboard** — The app surface to manage all Oz runs, unified across the Warp app and web.

- **Oz run** — A single execution lifecycle of an Oz agent, including actions, outputs, and logs. An Oz run is always ambient and cloud-based.
+- **Oz run** — A single execution lifecycle of an agent, including actions, outputs, and logs. An Oz run is always ambient and cloud-based.


we should get rid of this "ambient" messaging - that's no longer a thing

hongyi-chen · 2026-05-12T21:59:11Z


 * [Warp Drive](/knowledge-and-collaboration/warp-drive/#using-warp-drive-offline) (Some files may be read-only in offline mode)
-* [Oz agent](/agent-platform/local-agents/overview/)
+* [Agent](/agent-platform/local-agents/overview/)


hmm I'm not sure if Agent or Warp Agent here would be better, could go either way

…t' language - Rename 'Ambient Agents' to 'Cloud Agents' in terminology glossary and AGENTS.md - Remove 'ambient' from Oz run definition and CLI command descriptions - Remove 'interactive or ambient' from agent definition - Update style_lint.py PROPER_FEATURE_NAMES to match Co-Authored-By: Oz <oz-agent@warp.dev>

rachaelrenk · 2026-05-17T22:46:20Z

Re: @hongyi-chen's review comment about setting up the style lint to run on a schedule —

This is already covered! The existing scheduled agent "Docs: style lint (Codex)" runs Mon/Wed/Fri at 16:00 UTC using the same style_lint/SKILL.md skill from this repo.

The lint rules updated in this PR (specifically the OZ_TERMS_TO_AVOID patterns in style_lint.py) will be picked up automatically on the next scheduled run. These patterns now flag Oz agent, Oz cloud agent, Oz subagent, Oz conversation, and related deprecated terms, with proper code block and inline code skipping so CLI commands like oz agent run are not falsely flagged.

…aces - Add 'ambient agent(s)' to stale_terms.md as deprecated terminology - Add 'Ambient Agents' to terms-to-avoid in terminology.md and AGENTS.md with note that code identifiers (AmbientAgentConfig) are acceptable - Add lint rule to style_lint.py OZ_TERMS_TO_AVOID to auto-flag usage - Remove remaining 'ambient' language from oz-style-guidelines.md Co-Authored-By: Oz <oz-agent@warp.dev>

rachaelrenk and others added 5 commits May 11, 2026 12:06

Merge branch 'orchestrator/rename-oz-agent-platform-docs' into rename…

7881246

…-oz-agent-to-warp-agent

Merge branch 'orchestrator/rename-oz-agent-other-docs' into rename-oz…

569f349

…-agent-to-warp-agent

cla-bot Bot added the cla-signed label May 12, 2026

vercel Bot deployed to Preview May 12, 2026 16:56 View deployment

rachaelrenk self-assigned this May 12, 2026

oz-for-oss Bot reviewed May 12, 2026

View reviewed changes

Comment thread .agents/skills/style_lint/style_lint.py

vercel Bot deployed to Preview May 12, 2026 17:05 View deployment

Merge branch 'main' into rename-oz-agent-to-warp-agent

894529e

vercel Bot deployed to Preview May 12, 2026 18:16 View deployment

hongyi-chen approved these changes May 12, 2026

View reviewed changes

vercel Bot deployed to Preview May 17, 2026 22:34 View deployment

vercel Bot deployed to Preview May 17, 2026 22:52 View deployment

rachaelrenk merged commit 82a1512 into main May 17, 2026
8 checks passed

rachaelrenk deleted the rename-oz-agent-to-warp-agent branch May 17, 2026 23:05

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Rename 'Oz agent' to 'agent' / 'Warp Agent' across docs#68

Rename 'Oz agent' to 'agent' / 'Warp Agent' across docs#68
rachaelrenk merged 9 commits into
mainfrom
rename-oz-agent-to-warp-agent

rachaelrenk commented May 12, 2026 •

edited

Loading

Uh oh!

vercel Bot commented May 12, 2026 •

edited

Loading

Uh oh!

oz-for-oss Bot commented May 12, 2026 •

edited

Loading

Uh oh!

oz-for-oss Bot left a comment

Uh oh!

Uh oh!

hongyi-chen left a comment

Uh oh!

hongyi-chen May 12, 2026

Uh oh!

hongyi-chen May 12, 2026

Uh oh!

hongyi-chen May 12, 2026

Uh oh!

rachaelrenk commented May 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

rachaelrenk commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Scope

Decision rules applied

Uh oh!

vercel Bot commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oz-for-oss Bot commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oz-for-oss Bot left a comment

Choose a reason for hiding this comment

Overview

Concerns

Verdict

Uh oh!

Uh oh!

hongyi-chen left a comment

Choose a reason for hiding this comment

Uh oh!

hongyi-chen May 12, 2026

Choose a reason for hiding this comment

Uh oh!

hongyi-chen May 12, 2026

Choose a reason for hiding this comment

Uh oh!

hongyi-chen May 12, 2026

Choose a reason for hiding this comment

Uh oh!

rachaelrenk commented May 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

rachaelrenk commented May 12, 2026 •

edited

Loading

vercel Bot commented May 12, 2026 •

edited

Loading

oz-for-oss Bot commented May 12, 2026 •

edited

Loading