diff --git a/src/components/GuidesLanding.astro b/src/components/GuidesLanding.astro index 77a20c7f1..88f0ebeb9 100644 --- a/src/components/GuidesLanding.astro +++ b/src/components/GuidesLanding.astro @@ -42,7 +42,6 @@ const GUIDE_CATEGORIES: Record = { 'agent-workflows/how-to-edit-agent-code-in-warp': 'agents', 'agent-workflows/using-images-as-context-with-warp': 'agents', 'agent-workflows/understanding-your-codebase': 'agents', - 'agent-workflows/running-multiple-agents-at-once-with-warp': 'agents', 'agent-workflows/warp-for-product-managers': 'agents', 'agent-workflows/warp-vs-claude-code': 'agents', diff --git a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx index 77cad2abc..49e4bebde 100644 --- a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx +++ b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx @@ -10,6 +10,7 @@ tags: - "agents" --- +import VideoEmbed from '@components/VideoEmbed.astro'; Use multiple coding agents, including Warp Agent, Claude Code, Codex, and other CLI agents, when work can be split into independent tasks, reviewed from separate branches, or delegated to cloud agents while you keep working locally. In Warp, you can coordinate agents in three ways: @@ -133,6 +134,8 @@ Agent notifications are currently supported for Claude Code, Codex, and OpenCode
Agent approval notification.
+ + ## 4. Compare outputs from different agents A practical use of parallel agents is running the same task in different Git worktrees, with different agents, to compare their approaches. For example, prompt both Claude Code and Codex with the following: diff --git a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx deleted file mode 100644 index c5dd513c6..000000000 --- a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Run multiple agents at once with Warp -description: >- - Run multiple agent tasks simultaneously in Warp — revert PRs, edit - shortcuts, and add tests across repos without losing context. -sidebar: - label: "Run multiple agents at once" -tags: - - "agents" - ---- -import VideoEmbed from '@components/VideoEmbed.astro'; - - - -### 1. Why multiple agents matter - -Sometimes you need to work on several coding tasks at once — fix a PR, add a feature, debug a build — without losing context.\ -\ -Warp lets you run multiple agent tasks simultaneously, all within one workspace. - ---- - -### 2. How it works - -Each agent runs in its own thread, complete with: - -* Progress tracking -* Notifications when blocked or completed -* Separate command histories - -Because Warp is a desktop app, it can send system notifications to alert you when an agent finishes or when it needs review. To set up notifications for Claude Code, Codex, and OpenCode, see [Agent notifications](/agent-platform/capabilities/agent-notifications/). - ---- - -### 3. Example: reverting a PR and editing a shortcut - -Ben uses voice mode to quickly start tasks. - -Prompt Example:\ -“Find the PR where we added the keyboard shortcut to the UDI input and revert it.” - -He pastes in the PR number, and the agent: - -* Locates the relevant diff -* Reverts the change automatically -* Pushes it to the correct branch - -Warp notifies him when the task completes. - -Then, he runs another prompt: - -Prompt Example:\ -“Change the keyboard shortcut to `Cmd+Shift+I`.” - -Warp modifies `input.rs`, previews the diff, and Ben applies the change directly from Warp. - ---- - -### 4. Managing multiple tasks - -You can switch between concurrent agents: - -* Each task appears in a Task List panel -* Completed, canceled, and running tasks are color-coded -* Toast notifications appear when tasks are blocked - -You can even fast-forward agents to auto-approve all code diffs once you trust their trajectory. - ---- - -### 5. Parallel contexts - -In another repo, Ben adds a new Eval test via a different agent: - -Prompt Example:\ -“Create a Python hello world function and verify it prints ‘Hello World.’” - -Warp’s second agent: - -* Locates the correct file -* Writes the test code -* Verifies execution - -Meanwhile, the first agent continues working on the keyboard shortcut task. - ---- - -### 6. Reviewing all active agents - -Open the Agent Mode Dashboard to see: - -* Active tasks -* Completed tasks -* Logs and outputs - -You can refine or cancel tasks mid-run if needed, or switch back to manual commands. To track these runs across your account and team, including cloud agent runs, open the [Agent Management Panel](/platform/managing-cloud-agents/) in the Warp app. - -For a workflow-oriented setup guide that covers task decomposition, worktrees, cloud orchestration, validation, and review handoff, see [How to run multiple AI coding agents](/guides/agent-workflows/how-to-run-multiple-ai-coding-agents/). diff --git a/src/sidebar.ts b/src/sidebar.ts index 3adb29616..f7661f2f9 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -684,7 +684,6 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ { slug: 'guides/agent-workflows/how-to-review-prs-like-a-senior-dev', label: 'Review PRs like a senior dev' }, { slug: 'guides/agent-workflows/using-images-as-context-with-warp', label: 'Use images as context for agents' }, { slug: 'guides/agent-workflows/understanding-your-codebase', label: 'Understand a large codebase with agents' }, - { slug: 'guides/agent-workflows/running-multiple-agents-at-once-with-warp', label: 'Coordinate agents on separate tasks' }, ], }, { diff --git a/vercel.json b/vercel.json index deb9e20d1..0c8b80f2a 100644 --- a/vercel.json +++ b/vercel.json @@ -2405,6 +2405,11 @@ "destination": "/terminal/warpify/ssh/", "statusCode": 308 }, + { + "source": "/guides/agent-workflows/running-multiple-agents-at-once-with-warp", + "destination": "/guides/agent-workflows/how-to-run-multiple-ai-coding-agents/", + "statusCode": 308 + }, { "source": "/how-does-warp-compare/performance", "destination": "/terminal/comparisons/performance/",