Agentmaxxing Guide: How to Run Multiple AI Coding Agents in Parallel
7 min read
Updated
Learn how agentmaxxing works, the core parallel workflow using git worktrees, terminal orchestrators like cmux and NTM, and practical limits.
You open your terminal. Three panes. One AI agent is refactoring an API module in the left pane. Another is writing integration tests in the middle. A third is generating database migration scripts on the right. Each agent has its own git worktree. None of them know the others exist.
You review the pull requests over coffee.
This is agentmaxxing—the practice of running a fleet of parallel AI coding agents. Instead of pairing with a single AI, you decompose work, dispatch tasks to multiple agents simultaneously, and spend your time validating and merging output rather than writing code line-by-line.
Below is a practical look at how this workflow operates, the tools that enable it, and the honest limits of human-to-agent parallelism.
What Is Agentmaxxing?
The term follows the internet culture "-maxxing" pattern (optimizing a specific area to an extreme degree). In development, agentmaxxing means running multiple AI coding agents simultaneously, each on a separate task, in isolated workspaces.
This is distinct from multi-agent frameworks (like CrewAI or LangGraph) where agents coordinate with each other through defined protocols. Agentmaxxing is simpler: you are the coordinator. You decompose the work, launch the agents, review their output, and resolve merge conflicts.
This workflow shifts the developer's role from writer to reviewer and orchestrator. AI-forward teams are increasingly prioritizing this orchestration skill, as developers who manage parallel AI workflows effectively can ship features at a significantly accelerated pace.
Why This Workflow Is Practical Now
Three key developments have made running parallel agents viable:
- Unsupervised CLI Agents: Command-line agents like Claude Code, Gemini CLI, and Codex can now handle multi-file edits, run tests, and iterate on failures without constant hand-holding.
- Workspace Isolation with Git Worktrees: Running multiple agents on a single directory leads to immediate file conflicts. Git worktrees solve this by giving each agent its own isolated working directory on its own branch, while sharing the same underlying Git history.
- Dedicated Terminal Orchestration: Tools have emerged to manage multiple agent windows, broadcast prompts, and track completion statuses from a single interface.
The Core Workflow: Decompose, Launch, Review, Merge
Every parallel agent session follows a four-step loop:
Step 1: Decompose
Break the project into tasks that can run in parallel without depending on each other's immediate output.
- Good Decomposition:
- Agent A: Build the user settings API endpoint.
- Agent B: Write the settings page UI component.
- Agent C: Add database migrations for the new settings table.
- Bad Decomposition:
- Agent A: Build the settings backend API.
- Agent B: Build the frontend UI that calls the API before Agent A has finished defining the schema.
Step 2: Launch
Spin up each agent in its own terminal pane with its own git worktree. Give each agent a focused, specific prompt with clear boundaries.
# Create isolated worktrees
git worktree add ../settings-api feature/settings-api
git worktree add ../settings-ui feature/settings-ui
git worktree add ../settings-tests feature/settings-tests
# Launch agents in separate terminal panes
# Pane 1 (API):
cd ../settings-api && claude "Build a REST API for user settings. Endpoints: GET /api/settings, PUT /api/settings. Use the existing auth middleware. Write to src/api/settings.ts."
# Pane 2 (UI):
cd ../settings-ui && claude "Build a settings page component at src/components/SettingsPage.tsx. Use the existing form components. The API endpoint will be GET/PUT /api/settings."
Step 3: Review
As the agents run, watch for loops or errors, read completed code, and ensure each agent stayed within its assigned scope.
Step 4: Merge
Once the tasks are complete, merge the branches back into the main working branch:
git checkout main
git merge feature/settings-api
git merge feature/settings-ui
git merge feature/settings-tests
After merging, run the test suite to resolve any integration conflicts.
Terminal Setups for Orchestration
Managing multiple terminal windows requires the right interface. Developers typically use one of three setups:
1. cmux (macOS)
A native macOS terminal built on the Ghostty rendering engine, designed specifically for parallel AI agents. It features:
- Agent notifications: Visual rings on tabs when an agent finishes or encounters an error.
- Vertical tabs: Easily track multiple agent windows at a glance.
- Built-in browser: Preview your application directly within the utility.
2. NTM (Cross-Platform)
Named Tmux Manager (NTM) turns standard tmux into a multi-agent control center. It adds:
- Named panes: Label panes by task (e.g.,
api-agent,test-agent) instead of tracking terminal index numbers. - Broadcast prompts: Send a command (like a cancellation or save request) to all active panes simultaneously.
- Conflict detection: Warns you if two panes are editing the exact same file.
3. Plain tmux + Custom Scripts
For minimal dependencies, you can launch multiple agents using a simple bash script:
#!/bin/bash
SESSION="agentmax"
tmux new-session -d -s $SESSION
# Pane 1: Claude Code
tmux send-keys -t $SESSION "cd $(pwd)/worktree-api && claude" Enter
# Pane 2: Gemini CLI
tmux split-window -h -t $SESSION
tmux send-keys -t $SESSION "cd $(pwd)/worktree-tests && gemini" Enter
tmux attach -t $SESSION
While this lacks notifications and conflict detection, it requires zero external tools.
Industrial Orchestration: AMUX & Agent Farms
For large-scale tasks, developers use headless managers:
- AMUX: An open-source multiplexer designed for running parallel agents unattended. It features a SQLite-backed Kanban board to prevent agents from duplicating work, a web dashboard for live monitoring, and automated context compacting.
- Claude Code Agent Teams: An experimental mode where a primary Claude Code instance coordinates, reviews, and dispatches sub-tasks to teammate agents running in separate terminal panes.
Choosing the Right Agent Stack
Different AI models excel at different parts of the development workflow:
| Agent | Best For | Strengths |
|---|---|---|
| Claude Code (CLI) | Complex refactoring, architectural changes | Multi-file reasoning, subagent delegation for codebase research. |
| Gemini CLI | Fast generation, boilerplate, documentation | High speed, excellent for routine migrations and translations. |
| OpenAI Codex (Cloud) | Unattended background tasks | Runs on remote cloud environments, saving local CPU and memory. |
| Cursor / Windsurf | Visual front-end updates | Real-time workspace edits where visual confirmation is required. |
Tip: A standard parallel stack might run Claude Code locally for API logic, Gemini for database schema generation, and a cloud-based Codex instance updating the codebase documentation.
Workspace Isolation: Using Git Worktrees
Workspace isolation is critical; multiple agents writing to the same folder simultaneously will overwrite each other's work. Git worktrees solve this by letting you checkout multiple branches at once into different directories under a shared Git history.
# Create isolated workspaces for each agent
git worktree add ~/project-api feature/api-refactor
git worktree add ~/project-tests feature/test-coverage
git worktree add ~/project-docs feature/docs-update
Git Worktree Hygiene
- One Branch per Worktree: Never assign two active agents to the exact same branch.
- Specific Scope: Keep the directory scope narrow.
- Clean Up Regularly: Once a task is merged, remove the worktree with
git worktree remove <path>to keep your project space clean.
Voice Prompting for Speed
When managing three or four terminal windows, typing out instructions for each agent becomes a bottleneck. Many developers combine parallel agents with system-wide voice dictation tools (like Wispr Flow). Dictating prompts at 150+ words per minute allows you to dispatch multiple agents across separate panes in under a minute without manual typing.
The Spec-Driven Pattern
To avoid babysitting agents, you can use a spec-driven workflow:
- Write a thorough spec file (e.g.,
CLAUDE.md) detailing the system architecture, folder conventions, and API contracts. - Launch a lead agent to read the spec and spin up specialized sub-agents.
- Monitor progress through a central dashboard or shared markdown log file where agents write their status updates.
This pattern shifts your effort upfront into design and context creation rather than real-time debugging.
Where Agentmaxxing Breaks Down
- Rate Limits: Running multiple instances concurrently burns through API rate limits rapidly.
- The Review Bottleneck: If five agents finish their tasks at the same time, you are left with five pull requests to review simultaneously. The speed of the developer's review remains the ultimate bottleneck.
- Shared Resource Conflict: Multiple agents trying to write to the same database, run the same local port, or write to the same testing file will cause silent corruption. Use lock files or mock databases to isolate them.
- Negative ROI on Small Tasks: Setting up worktrees, writing clean prompts, and managing merges takes 5–10 minutes of overhead. For tasks that take under 15 minutes, a single agent is faster.
Conclusion
Agentmaxxing is highly effective for projects with 3+ parallelizable tasks that take at least 30 minutes to run sequentially. Start simple: open two terminal panes with two git worktrees. As you get comfortable reviewing code in parallel, you can scale up your fleet to match your review capacity.