Warp Factories quickstart

A factory is a team of cloud agents: a foreman you talk to, plus the subagents it dispatches. Together they turn incoming requests into pull requests for your team to review. In this quickstart, you will create a factory and take one small work item from prompt to pull request in about 10 minutes.

What you’ll decide

Warp walks you through factory setup in a wizard, so the work is deciding four things rather than learning a form:

• Which code the factory works on - the code host and the set of repositories.
• What it’s called - the factory’s name, and the handle your team @-mentions to reach its foreman.
• Which agents it runs - the subagents the foreman can dispatch.
• Where work comes from - optionally, a chat tool and an issue tracker.

Every one of these is editable afterward, so pick something reasonable and keep moving.

Prerequisites

• Warp Factories access - Warp Factories is in Early Access. Request access if your team doesn’t have it yet.
• A Warp team with credits - A factory belongs to a Warp team. Factory agents consume the team’s credits.
• Repository access - You authorize a code host during setup and choose which repositories the factory can reach. If your organization restricts app installations, ask an owner to approve the connection. See the GitHub and GitLab integration guides.

Set up your factory

~5 minutes

Sign in to the Warp Factories web app at platform.warp.dev and start a new factory. Setup asks you for the following.

Connect a code host and choose repositories

Authorize GitHub or GitLab, then select the repositories the factory works in.

Start with one or two. Every agent in the factory shares this repo set, so a focused set keeps their context tight, and you can add more later. Warp provisions a default environment for what you select.

Name the factory and its foreman

Factory name identifies the factory in the app. Foreman name is the handle your team @-mentions to reach its foreman from connected tools like Slack and Linear, so keep it short and recognizable. Warp derives one from the factory name if you don’t set it yourself.

Confirm the agent roster

The foreman is always there — it’s the agent you talk to. You choose which subagents it can dispatch:

Subagent	What it does
Triage	Accepts work from issue trackers and establishes scope
Spec	Iterates with your team to produce a spec
Code	Implements the change and opens the pull request
Review	Inspects the result and reports findings

All four start enabled and a factory needs at least one, so this step is about turning off what you don’t want yet. Leave Code on so this quickstart can end in a pull request.

See factory agents for what each role does in depth; the roster’s Code toggle is the Implement role on that page.

Optionally connect Slack and an issue tracker

Setup offers to connect a chat tool and an issue tracker, so teammates can hand work to the factory from where they already work. Skip both if you want to finish quickly — connect your factory covers adding them later.

Warp then creates the factory and opens its dashboard.

Send your first work item

~5 minutes

1. On your factory’s Runs page, start a new run.

2. Describe one small, verifiable change and submit it:

   Example first request

   Add a "Local development" section to README.md that summarizes the setup
   steps from CONTRIBUTING.md. Keep the change to that one file, run the
   repo's lint check, and open a pull request.

   Adapt the pattern to your repository: name the file, the change you expect, and the command that verifies it. A narrow, explicit request makes the first run easy to judge.

   The foreman picks up the request and dispatches your subagents as child runs.

3. Follow it from two places in the factory’s dashboard:

   • Runs - the foreman’s run and the child runs it dispatches.
   • Activity - the work item as it moves through its stages. Open it for the event history and pull request artifacts.

4. When the Code agent finishes, the work item links a pull request. Review and merge it the way you would any other: a factory hands off at the pull request and never merges for you.

Next steps

• Connect your factory - Route work in from Slack threads, Linear issues, and other intake paths.
• Factory MCP - Send work to the factory from a coding agent or MCP client.
• How Warp Factories work - The work-item lifecycle and where people stay in the loop.
• Troubleshooting - Fixes for common issues during setup and your first runs.