Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .agents/references/terminology.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ For the summary of the most critical terms (core features, Automation Platform t

## Automation Platform terminology

Renamed from "Oz" on 2026-08-18. Two surfaces keep the Oz name until 2026-09-15
Renamed from "Oz" on 2026-08-18. Two surfaces keep the Oz name until 2026-10-06
and are **not** stale in the meantime: the `oz` CLI binary and the Oz v1 web app
at `oz.warp.dev`. See "What still says Oz" at the end of this section.

Expand Down Expand Up @@ -173,7 +173,7 @@ catches the literal, `platform-determiner` catches a missing article.
*Usage note:* In prose the term takes the definite article — "the Warp Agent". Reserve the bare form for headings, sidebar labels, page titles, and the Settings path. "Runs the Warp Agent" reads correctly; "runs Warp Agent" reads as a different product.
- **The Automation Platform is the platform, not the agent.** Never introduce it as "Warp's agent" or equate the two. The Automation Platform runs and coordinates agents; the Warp Agent is the agent.
- **Warp Agent CLI** — The standalone terminal program (the `warp` binary) that runs the Warp Agent in any terminal, including over SSH and on machines without the Warp app. Documented at `/agents/cli/`.
*Usage note:* Distinct from the Oz CLI (the `oz` binary), which runs and manages cloud agents. The Oz CLI is retired and wrapped into the Warp Agent CLI on 2026-09-15, matching the `oz` binary holdout in "What still says Oz" below — not the 8/18 platform rename. Until that ships, keep the two clearly separate in prose; afterwards, "Warp Agent CLI" covers both. `oz` commands themselves remain supported through the end of September 2026; the successor `warp` CLI commands for CLI-scripted workflows (environments, secrets, integrations, schedules) haven't been defined yet.
*Usage note:* Distinct from the Oz CLI (the `oz` binary), which runs and manages cloud agents. The Oz CLI is retired and wrapped into the Warp Agent CLI on 2026-10-06, matching the `oz` binary holdout in "What still says Oz" below — not the 8/18 platform rename. Until that ships, keep the two clearly separate in prose; afterwards, "Warp Agent CLI" covers both. `oz` commands themselves remain supported through the end of September 2026; the successor `warp` CLI commands for CLI-scripted workflows (environments, secrets, integrations, schedules) haven't been defined yet.
- **Automation Platform** — Warp's programmable platform for running and coordinating agents at scale
- There is typically one Warp environment per user session. The Automation Platform can run many agents concurrently, across machines, repos, and teams.

Expand All @@ -198,7 +198,7 @@ catches the literal, `platform-determiner` catches a missing article.
*Usage note:* This is the platform-level default (HYC, 2026-08-17). Use `{VARS.PLATFORM_RUN}`, or "Warp cloud agent run" when you need to disambiguate from another vendor's runs. On pages that are specifically about a factory, write "factory run" directly instead — the variable holds the general term, so it cannot carry that distinction.

- **Oz web app** — The web app for configuring agents and managing runs.
*Usage note:* Holds the Oz name until 2026-09-15. Use `{VARS.WEB_APP}`.
*Usage note:* Holds the Oz name until 2026-10-06. Use `{VARS.WEB_APP}`.

- **subagent** — A child agent created by a parent agent to parallelize or delegate work.

Expand Down Expand Up @@ -243,7 +243,7 @@ ended — "Ask the Automation Platform to..." is plainly wrong. Address the agen
### What still says Oz

Not every "Oz" in the docs is stale. These are deliberate and correct until
2026-09-15, when they get their own value flip:
2026-10-06, when they get their own value flip:

- **The `oz` binary** and every `oz <command>` invocation. Commands inside code
fences are never rewritten. `{VARS.WARP_AGENT_CLI}` renders "Oz CLI".
Expand Down
4 changes: 2 additions & 2 deletions .agents/skills/style_lint/style_lint.py
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@
# only mean "this should have been tokenized" -- a hardcoded "Oz" in prose is
# now a *stale* product name as well. Both readings want the same fix, so the
# entries stay. The "Automation Platform" entry is the mirror image: it catches
# the new name being hardcoded, which would silently miss the 9/15 changes and
# the new name being hardcoded, which would silently miss the 10/6 changes and
# any later rename.
#
# Each entry: (literal_string, var_key, suggestion)
Expand Down Expand Up @@ -130,7 +130,7 @@
"Oz is now",
"was called Oz",
"renamed from Oz",
# Explains why "Oz" still appears in commands and URLs before 9/15.
# Explains why "Oz" still appears in commands and URLs before 10/6.
"the Oz name",
)

Expand Down
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -821,7 +821,7 @@ This is the single most drifted term in the docs, so the rule is narrow on purpo

### Automation Platform terminology

Renamed from "Oz" on 2026-08-18. The `oz` CLI binary and the Oz v1 web app at `oz.warp.dev` keep the Oz name until 2026-09-15 and are not stale in the meantime. See `.agents/references/terminology.md` → "What still says Oz" for the full holdout list.
Renamed from "Oz" on 2026-08-18. The `oz` CLI binary and the Oz v1 web app at `oz.warp.dev` keep the Oz name until 2026-10-06 and are not stale in the meantime. See `.agents/references/terminology.md` → "What still says Oz" for the full holdout list.

#### The article rule
"Oz" was a proper noun and read correctly bare. "Automation Platform" is a common-noun phrase, so it needs a definite article in referential positions. This is the most common mistake when writing about the platform.
Expand All @@ -846,7 +846,7 @@ Write the name as `{VARS.WARP_AUTOMATION_PLATFORM}` in body prose or `{{WARP_AUT
- **cloud agent run** - A single execution lifecycle of an agent, including actions, outputs, and logs. Always cloud-based. Use `{VARS.PLATFORM_RUN}`. On factory-specific pages, write "factory run" directly.
- **Environment** - The execution context for an agent, including repo access, dependencies, secrets, compute, and runtime configuration
- **cloud agent dashboard** - The app surface to manage all runs, unified across the Warp app and web. Use `{VARS.DASHBOARD}`. On factory-specific pages, write "factory dashboard" directly.
- **Oz web app** - The web app for configuring agents and managing runs. Holds the Oz name until 2026-09-15; use `{VARS.WEB_APP}`.
- **Oz web app** - The web app for configuring agents and managing runs. Holds the Oz name until 2026-10-06; use `{VARS.WEB_APP}`.

#### Oz CLI commands
- `oz agent run` - Run a local agent
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/platform/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ sidebar:
import { VARS } from '@data/vars';
import VideoEmbed from '@components/VideoEmbed.astro';

{/* Transition notice for the 2026-08-18 rename. Remove after 2026-09-15, when
{/* Transition notice for the 2026-08-18 rename. Remove after 2026-10-06, when
the CLI and web app take their new names and the old one stops appearing. */}
:::note
**Oz is now the [{VARS.WARP_AUTOMATION_PLATFORM}](/platform/overview/).** Only the name changed. Your existing cloud agents, integrations, API keys, and schedules keep working exactly as before. The `oz` CLI and the <a href={VARS.WEB_APP_URL}>{VARS.WEB_APP}</a> keep the Oz name until September 15, 2026.
**Oz is now the [{VARS.WARP_AUTOMATION_PLATFORM}](/platform/overview/).** Only the name changed. Your existing cloud agents, integrations, API keys, and schedules keep working exactly as before. The `oz` CLI and the <a href={VARS.WEB_APP_URL}>{VARS.WEB_APP}</a> keep the Oz name until October 6, 2026.
:::

Cloud agents are autonomous, background agents that run on Warp's cloud infrastructure or your own, triggered by system events, schedules, or integrations like Slack and GitHub. They execute tasks with full observability — every run is tracked, inspectable, and shareable across your team.
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/platform/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,12 @@ import { VARS } from '@data/vars';

If you're new to cloud agents, the [Cloud agents quickstart](/platform/quickstart/) gets you to your first run in about ten minutes.

{/* Transition notice for the 2026-08-18 rename. Remove after 2026-09-15, when
{/* Transition notice for the 2026-08-18 rename. Remove after 2026-10-06, when
the CLI and web app take their new names and the old one stops appearing. */}
:::note
**Oz is now the {VARS.WARP_AUTOMATION_PLATFORM}.** Only the name changed. Your existing integrations, API keys, scheduled agents, and scripts keep working exactly as before — nothing to migrate.

The `oz` CLI and the <a href={VARS.WEB_APP_URL}>{VARS.WEB_APP}</a> keep the Oz name until September 15, 2026, which is why you'll still see it in commands and URLs.
The `oz` CLI and the <a href={VARS.WEB_APP_URL}>{VARS.WEB_APP}</a> keep the Oz name until October 6, 2026, which is why you'll still see it in commands and URLs.
:::

<VideoEmbed url="https://youtu.be/poLkJhO7fdo" title={`${VARS.WARP_AUTOMATION_PLATFORM} cloud agents overview video`} />
Expand Down
12 changes: 6 additions & 6 deletions src/data/vars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

export const VARS = {
// Platform — renamed 8/18. The remaining Oz-valued keys below are the
// deliberate 9/15 holdouts: the `oz` binary and the Oz v1 webapp keep their
// deliberate 10/6 holdouts: the `oz` binary and the Oz v1 webapp keep their
// names until that date, so they are NOT stale, they are pending.
//
// IMPORTANT: "Automation Platform" is a common-noun phrase, not a proper
Expand All @@ -17,9 +17,9 @@ export const VARS = {
// attributive uses do not ("{{…}} settings", "{{…}}-hosted"). style_lint
// enforces this. Do not add a bare referential use.
WARP_AUTOMATION_PLATFORM: "Automation Platform",
WARP_AGENT_CLI: "Oz CLI", // the `oz` binary — holds until 9/15, then "Warp Agent CLI"
WEB_APP: "Oz web app", // legacy Oz v1 webapp (oz.warp.dev) — holds until 9/15
WEB_APP_URL: "https://oz.warp.dev", // holds until 9/15, then "https://app.warp.dev"
WARP_AGENT_CLI: "Oz CLI", // the `oz` binary — holds until 10/6, then "Warp Agent CLI"
WEB_APP: "Oz web app", // legacy Oz v1 webapp (oz.warp.dev) — holds until 10/6
WEB_APP_URL: "https://oz.warp.dev", // holds until 10/6, then "https://app.warp.dev"
// Renamed per HYC (8/17), same shape as PLATFORM_RUN below: a plain
// platform-level term, with "factory dashboard" written directly on pages
// that are specifically about a factory. Lowercase: "Warp Factories" is the
Expand All @@ -41,7 +41,7 @@ export const VARS = {
// Kept singular so `{VARS.PLATFORM_RUN}s` pluralizes correctly at the call
// sites that do that.
PLATFORM_RUN: "cloud agent run",
API_SDK_NAME: "Oz API & SDK", // holds until 9/15, then "Warp API & SDK"
API_SDK_NAME: "Oz API & SDK", // holds until 10/6, then "Warp API & SDK"

// Warp Factories web app — a net-new product surface at platform.warp.dev
// (soft launch ~2026-08-18), separate from the legacy Oz v1 webapp above.
Expand All @@ -55,7 +55,7 @@ export const VARS = {
//
// NOTE: the WARP_AGENT_CLI key above was reserved for renaming the Oz CLI to
// this same name. That overlap is now resolved by product direction: on
// 2026-09-15 (the same holdout date as the WARP_AGENT_CLI value above, not
// 2026-10-06 (the same holdout date as the WARP_AGENT_CLI value above, not
// the 8/18 platform rename) the Oz CLI is retired and wrapped into the Warp
// Agent CLI, leaving a single CLI. The two keys are expected to collapse
// into one at that point. Keeping them separate until the convergence
Expand Down
4 changes: 2 additions & 2 deletions src/sidebar.ts
Original file line number Diff line number Diff line change
Expand Up @@ -534,8 +534,8 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
{ slug: 'platform/viewing-cloud-agent-runs', label: 'Session sharing' },
{ slug: 'platform/managing-cloud-agents', label: 'Managing cloud agents' },
// Tokenized, not renamed: WEB_APP holds its "Oz web app" value
// until 9/15, so this renders identically today. Tokenizing now
// means the 9/15 flip reaches the sidebar, which the Vite
// until 10/6, so this renders identically today. Tokenizing now
// means the 10/6 flip reaches the sidebar, which the Vite
// transform does not process.
{ slug: 'platform/oz-web-app', label: VARS.WEB_APP },
],
Expand Down
Loading