Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
0f8dcb6
docs: route factory acquisition through get started
warp-agent-staging[bot] Oct 6, 2026
a7dae33
docs: prepare Warp Factories for general availability
warp-agent-staging[bot] Oct 6, 2026
3503302
docs: clarify factory governance roles
warp-agent-staging[bot] Oct 6, 2026
ac46131
docs: add two-path Factories landing CTA
warp-agent-staging[bot] Oct 6, 2026
ec10980
Merge remote-tracking branch 'origin/main' into factory/factories-acq…
warp-agent-staging[bot] Oct 6, 2026
8343bb8
docs: consolidate Warp Factories launch readiness
warp-agent-staging[bot] Oct 6, 2026
a064ef0
docs: reconcile concurrent Factories CTA updates
warp-agent-staging[bot] Oct 6, 2026
ee8dae8
docs: use link cards for Factories access paths
warp-agent-staging[bot] Oct 6, 2026
1553149
docs: clarify Factories setup permissions
warp-agent-staging[bot] Oct 6, 2026
9d3fcab
docs: clarify Factories CTA outcomes
warp-agent-staging[bot] Oct 6, 2026
5a0c8da
docs: integrate concurrent Factories CTA clarification
warp-agent-staging[bot] Oct 6, 2026
7ad7d8e
docs: resolve Factories launch review findings
warp-agent-staging[bot] Oct 6, 2026
bd7f5ae
docs: address factories launch review
warp-agent-staging[bot] Oct 6, 2026
bd65cf9
docs: correct Factories setup instructions
warp-agent-staging[bot] Oct 6, 2026
3a550b6
docs: compress Teams setup guidance
warp-agent-staging[bot] Oct 6, 2026
63e09a0
docs: clarify Factories CTA audiences
warp-agent-staging[bot] Oct 6, 2026
87a2c0f
docs: balance Factories CTA copy
warp-agent-staging[bot] Oct 6, 2026
9fb9c5f
docs: refine Factories access and setup guidance
warp-agent-staging[bot] Oct 6, 2026
d5d59a2
docs: keep Factories access badge removed
warp-agent-staging[bot] Oct 6, 2026
7b5fb65
docs: retain Factories Early Access badge
warp-agent-staging[bot] Oct 6, 2026
7e64455
Merge branch 'main' into factory/factories-acquisition-ctas
hongyi-chen Oct 6, 2026
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
9 changes: 4 additions & 5 deletions src/components/WarpTopicNav.astro
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,10 @@
// underline share `--sl-color-text-accent`, which auto-adapts to dark
// and light themes.
// - No surrounding chip / box / bg — just type + icon
// - Topic badge (e.g. Factories "Early Access"): rendered as a plain span
// styled as a compact brand pill (Inter, 11px/600, accent tint, fully
// rounded) instead of Starlight's `<Badge>`, whose monospace bordered
// box clashed with the nav type and was wide enough to wrap the nav
// onto a second row at common laptop widths.
// - Topic badges render as compact brand pills (Inter, 11px/600, accent
// tint, fully rounded) instead of Starlight's `<Badge>`, whose bordered
// monospace box clashed with the nav type and was wide enough to wrap the
// nav onto a second row at common laptop widths.
import { Icon } from '@astrojs/starlight/components';

const { topics } = Astro.locals.starlightSidebarTopics;
Expand Down
8 changes: 2 additions & 6 deletions src/content/docs/factories/benchmarks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,7 @@ sidebar:
import { VARS } from '@data/vars';
import VideoEmbed from '@components/VideoEmbed.astro';

:::note
Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team.
:::

Warp Factories benchmarks compare model and runner configurations for one factory agent on the same fixed tasks. Use a benchmark to test a change on representative work before you apply it to your factory.
Warp Factories benchmarks compare model, harness, and runner configurations for one factory agent on the same fixed tasks. Use a benchmark to test a change on representative work before you apply it to your factory.
This video shows how to compare benchmark results for quality and cost before changing a coding agent's configuration.
<VideoEmbed url="https://www.youtube.com/watch?v=LKx5MeUsptQ" title="Comparing factory benchmark results to reduce coding agent costs" />

Expand Down Expand Up @@ -67,7 +63,7 @@ This video shows how to turn your team's coding tasks into a reusable benchmark
![The task editor with fields for a title, prompt, correctness criteria, and pinned repositories.](../../../assets/factories/benchmark-task-editor.png)
<figcaption>The task editor for a benchmark suite.</figcaption>
</figure>
6. Click **Run**. In the launch dialog, choose the model or an authorized custom factory router and the runner for each configuration. Third-party harness comparisons are not available yet.
6. Click **Run**. In the launch dialog, choose the harness and model, or an authorized custom factory router, and the runner for each configuration.
7. Add configurations, select Scorers, and set "Repetitions." The dialog shows the number of trials created. More trials and Scorers increase the run's cost.
8. Click **Run benchmark**. The benchmark page shows its status and scored trials. You can cancel a running or scoring benchmark.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/factories/connect-your-factory.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ GitHub, GitLab.com, and Azure DevOps Services connect both repositories and prov

## Choose a source

Pick the sources that match where work starts for your team. You can connect multiple sources, but not both Linear and Jira at the same time. The setup wizard currently offers Linear; to use Jira, connect it after setup or in your [factory definition](/factories/factory-as-code/).
Pick the sources that match where work starts for your team. You can connect multiple sources, but not both Linear and Jira at the same time. Choose either issue tracker during setup, or connect one later from the factory's settings or [definition](/factories/factory-as-code/).

Once a source is connected, here's the concrete action that hands it work — each links to that integration's full instructions rather than repeating them.

Expand Down
4 changes: 0 additions & 4 deletions src/content/docs/factories/factory-agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,6 @@ sidebar:
label: "Factory agents"
---

:::note
Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team.
:::

Every factory has a **foreman**, the agent you talk to from the tool that sends the request, such as Slack or Linear. Four other default agents each cover one part of the software development lifecycle: triage scopes the request, spec writes the plan, implement writes the code, and review checks it. Together they take a work item from the moment it reaches your factory to a pull request ready for review.

## The default agents
Expand Down
4 changes: 0 additions & 4 deletions src/content/docs/factories/factory-api.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,6 @@ import { VARS } from '@data/vars';

The factory endpoints are part of the {VARS.WARP_PLATFORM_API}. Use them to find a factory and start work from a custom integration without managing agent details. Build them into a chat bot, script, or service for any tool Warp doesn't connect to directly.

:::note
Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team.
:::

## How it works

* `GET /factory` - list factories your account can access. Add `search` to filter by name or alias, case-insensitive.
Expand Down
4 changes: 0 additions & 4 deletions src/content/docs/factories/factory-skills.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,6 @@ sidebar:
label: "Factory skills"
---

:::note
Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team.
:::

A skill tells an agent what to check, how to classify results, what to produce, and when to escalate. In a factory, skills are how you extend or override [default agents](/factories/factory-agents/), without editing their prompts directly.

## Skill sources in a factory
Expand Down
4 changes: 0 additions & 4 deletions src/content/docs/factories/how-factories-work.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,6 @@ sidebar:
label: "How factories work"
---

:::note
Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team.
:::

A factory is a fleet of agents wired to your software development lifecycle. It connects your repositories and tools to move requests through triage, specification, implementation, review, and verification, while people stay in control of key decisions. You talk to one agent, the **foreman**, from the tool that sends the request, such as Slack or Linear. The foreman dispatches the factory's other agents, and each one owns a part of the software development lifecycle.

Deciding which repositories belong in this factory is a separate question. See [sizing a factory](/factories/#sizing-a-factory) for that guidance.
Expand Down
18 changes: 14 additions & 4 deletions src/content/docs/factories/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,24 @@ sidebar:
label: "Overview"
---
import { VARS } from '@data/vars';
import { CardGrid, LinkCard } from '@astrojs/starlight/components';
import VideoEmbed from '@components/VideoEmbed.astro';

:::note
Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. If your team already has access, sign in to the <a href={VARS.FACTORY_WEB_APP_URL}>{VARS.FACTORY_WEB_APP}</a>.
:::

A factory is a group of agents that shares repositories and delivery policy. Its foreman accepts work from connected tools, dispatches the right agents, and returns the result to the source.

<CardGrid>
<LinkCard
title="Get started with Warp Factories"
href={VARS.GET_STARTED_URL}
description="For prospective users and teams new to Warp Factories."
/>
<LinkCard
title="Open Warp Factories"
href={VARS.FACTORY_WEB_APP_URL}
description="For existing users and teams already using Warp Factories."
/>
</CardGrid>

<VideoEmbed url="https://www.youtube.com/watch?v=0WBk4ai8y1A" title="Introducing Warp Factories" />

## What is a software factory?
Expand Down
61 changes: 33 additions & 28 deletions src/content/docs/factories/infrastructure-and-security.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@ sidebar:
label: "Infrastructure & security"
---

Warp Factories runs on the infrastructure your team chooses. You decide where a factory runs code, which model providers serve its inference requests, and which credentials each agent receives. Warp coordinates the work and stores run data such as transcripts and artifacts.
Warp Factories separates execution, inference, and credential boundaries. You choose where code runs, which providers serve inference, and which credentials each agent receives. Warp coordinates the work and stores transcripts and artifacts.

## Control plane and execution plane

Every factory splits responsibilities across two planes:
Each factory uses two planes:

* **Control plane** - Warp coordinates runs, identity and configuration, observability, integrations, storage, and inference routing.
* **Execution plane** - A Warp-hosted sandbox or a managed self-hosted worker checks out code, runs setup, invokes tools, builds the project, and executes commands.
Expand All @@ -27,17 +27,13 @@ flowchart LR
C --> D["Warp-managed storage"]
```

Self-hosting moves only the execution plane: with a managed self-hosted worker, repository checkouts, command execution, and the sandbox filesystem stay on machines you control, but content that enters prompts, results, transcripts, attachments, artifacts, or telemetry still flows through Warp and the providers you configure. See [deployment patterns](/factories/deployment-patterns/) and [execution security](/platform/execution-security/) for the broader data model.

The diagram below maps those boundaries for self-hosted execution; factory runs follow the same data model. See the [data security and boundaries](/platform/architecture/#data-security-and-boundaries) reference for a description of each data class.
With managed self-hosting, repository checkouts, commands, and sandbox files stay on machines you control. Prompts, results, transcripts, attachments, artifacts, and telemetry still flow through Warp and configured providers. See [deployment patterns](/factories/deployment-patterns/), [execution security](/platform/execution-security/), and the [data security and boundaries](/platform/architecture/#data-security-and-boundaries) reference for details.

![Self-hosted data security and boundaries diagram showing what stays in customer infrastructure, what Warp retains, and what transits Warp to model providers](../../../assets/agent-platform/data-security-boundaries.png)

## Runners

A runner defines the compute a factory's agents work on: the operating system and architecture, the sandbox image, and the instance shape (vCPUs and memory). The workspace itself — repositories, setup commands, and secrets — comes from the factory's [definition](/factories/factory-as-code/). See the [runner reference](/factories/runners/) for the available compute options.

Declare runners as `runners/*.yaml` files. Every agent inherits `agentDefaults.runner`, and an agent or automation can override it. The execution host determines how the runner's compute settings are used:
A runner selects the operating system, architecture, sandbox image, and vCPU and memory shape. The factory's [definition](/factories/factory-as-code/) supplies repositories, setup commands, and secrets. Define runners in `runners/*.yaml`; `agentDefaults.runner` sets the default, and agents and automations can override it. The execution host determines how each setting is used:

| Setting | Warp-hosted | Direct | Kubernetes | Docker |
| --- | --- | --- | --- | --- |
Expand All @@ -46,9 +42,7 @@ Declare runners as `runners/*.yaml` files. Every agent inherits `agentDefaults.r
| `platform.linux.registryCredentialSecretName` | Warp-managed private-registry credential | Ignored | Ignored; use `imagePullSecrets` | Ignored; configure registry credentials on the worker, such as in its Docker config |
| `instanceShape` | Sandbox size, subject to plan limits; omitted uses the workspace default | Ignored; the task uses host resources | Task-container requests and limits; overrides matching `pod_template` resources; omitted keeps template or cluster defaults | Task-container limits; omitted adds no limits |

Self-hosted runner settings do not provision worker capacity. Worker configuration controls host resources, registry authentication, volumes, node placement, and other backend policy.

See [cloud agent runner compute options](/factories/runners/) and [factory runner syntax](/factories/factory-as-code/#runnersnameyaml).
Self-hosted runner settings don't provision capacity. Worker configuration controls resources, registry authentication, volumes, placement, and backend policy. See [runner compute options](/factories/runners/) for available configurations.

## Choose an execution host

Expand All @@ -74,7 +68,7 @@ Unmanaged self-hosted agents and other CLI agents can't serve as a factory's exe

### Managed self-hosting structures

Factories use managed self-hosting, so Warp still orchestrates their runs. The worker backend sets isolation and scheduling on your infrastructure:
The worker backend sets isolation and scheduling on your infrastructure:

| Structure | How factory runs execute | What your team operates | Use it when |
| --- | --- | --- | --- |
Expand Down Expand Up @@ -113,27 +107,38 @@ A factory handles four kinds of credentials, each with its own boundary:

Scope each credential to the resources and actions its agent needs. Warp redacts known secret values at output boundaries, but redaction is a backstop, not a substitute for narrow external permissions and rotation. See [cloud agent secrets](/platform/secrets/), [harness authentication](/platform/harnesses/authentication/), [secret redaction](/support-and-community/privacy-and-security/secret-redaction/), and [team identity](/platform/team-access-billing-and-identity/) for the underlying controls.

## Governance and metering
## Factory roles and permissions

Factory creation uses the team-level Warp Factories role. Team and workspace admins and team-level Editors can create factories.

Three roles govern an existing factory:

* **User** - View and run the factory, and propose definition changes.
* **Editor** - Edit the factory definition, configure its agents, repositories, and automations, attach existing integrations, secrets, and MCP servers, and select existing runners.
* **Admin** - Manage members, delete the factory, and force-merge a blocked definition change.

Team and workspace admins and owners always have the Admin role. Admins for a factory manage its roles; team and workspace admins manage the team-level role.

Managing shared runners and connecting team-wide integrations and providers require team or workspace permission. Factory roles don't control specification or pull request review. Treat factory definition changes as operational code, and protect merges through repository settings.

Factories use your existing [team roles](/enterprise/team-management/roles-and-permissions/): Team Owners and Admins control factory definitions, runners, secrets, and provider configuration. Warp Factories doesn't add a factory-specific approval role, so who reviews specifications and who approves merges stays a workflow and repository policy decision. Treat factory-definition changes as operational code: review them like any other change, and keep merge access with the people responsible for shipping.
## Metering

Warp meters hosted compute, Warp-provided inference, and platform services. Managed self-hosted execution moves compute costs to your own infrastructure, and customer-supplied inference bills model usage through your provider account. Platform services consume credits regardless of these choices. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for details.
Warp meters hosted compute, Warp-provided inference, and platform services. Self-hosting moves compute costs to your infrastructure; customer-supplied inference bills your provider account. Platform services still consume credits. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for details.

## Deployment checklist

1. **Classify the workload** - Identify the repositories, data, internal services, and regulated systems the factory can reach.
2. **Choose execution** - Decide where checkout, commands, and the sandbox filesystem must run.
3. **Configure the factory and its runners** - Set the repositories, setup commands, secrets, and compatible runners in the factory's definition.
4. **Choose inference** - Select provider routing.
5. **Scope credentials** - Set each agent's secret allowlist, harness authentication, and repository identity.
6. **Set review gates** - Decide where humans review specifications and pull requests, and enforce those gates in workflow and repository policy.
7. **Validate operations** - Test network egress, isolation, rotation, redaction, capacity, observability, and metering before increasing volume.
1. **Classify access** - Inventory repositories, data, and services.
2. **Set boundaries** - Choose execution and inference hosts.
3. **Scope credentials** - Configure allowlists, harness authentication, and repository identity.
4. **Enforce review** - Protect factory-definition and pull request merges.
5. **Validate operations** - Test egress, isolation, rotation, capacity, observability, and metering.

## Related pages

* [**Deployment patterns**](/factories/deployment-patterns/) - Compare Warp-hosted, managed self-hosted, and CLI-only execution.
* [**Managed self-hosting**](/factories/self-hosting/) - Choose a worker backend and follow its setup guide.
* [**Execution security**](/platform/execution-security/) - Review data boundaries, network egress, and backend-specific controls.
* [**Bring Your Own LLM**](/enterprise/enterprise-features/bring-your-own-llm/) - Compare customer-owned inference options and provider support.
* [**Enterprise security overview**](/enterprise/security-and-compliance/security-overview/) - Review data handling, ZDR, compliance, and access controls across Warp.
* [Team-managed model keys and endpoints](/enterprise/enterprise-features/team-managed-keys-and-endpoints/) - Configure customer-supplied inference credentials.
* [**Deployment patterns**](/factories/deployment-patterns/) - Compare execution and inference boundaries.
* [**Runners**](/factories/runners/) - Configure compute and worker compatibility.
* [**Managed self-hosting**](/factories/self-hosting/) - Deploy and operate a worker backend.
* [**Execution security**](/platform/execution-security/) - Review data boundaries, egress, and backend controls.
* [**Team-managed model keys and endpoints**](/enterprise/enterprise-features/team-managed-keys-and-endpoints/) - Configure inference credentials.
* [**Roles and permissions**](/enterprise/team-management/roles-and-permissions/) - Govern team and workspace resources.
* [**Platform credits**](/support-and-community/plans-and-billing/platform-credits/) - Understand factory metering.
Loading
Loading