Skip to content

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

Open
rachaelrenk wants to merge 7 commits into
mainfrom
rename-oz-agent-to-warp-agent
Open

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

Conversation

@rachaelrenk
Copy link
Copy Markdown
Contributor

@rachaelrenk rachaelrenk commented May 12, 2026

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

rachaelrenk and others added 5 commits May 11, 2026 12:06
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>
@cla-bot cla-bot Bot added the cla-signed label May 12, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 12, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 12, 2026 6:16pm

Request Review

@oz-for-oss
Copy link
Copy Markdown
Contributor

oz-for-oss Bot commented May 12, 2026

@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

Copy link
Copy Markdown
Contributor

@oz-for-oss oz-for-oss Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment thread .agents/skills/style_lint/style_lint.py
- 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>
Copy link
Copy Markdown
Collaborator

@hongyi-chen hongyi-chen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

## 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.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we should change this to something closer to oz cloud agents

- **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.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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


* [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/)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

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