@johannesjo/parallel-codePublic

Tools#Claude Code #Codex #Gemini CLI #Copilot#Coding #Testing #Product

Parallel agent worktree manager for Claude Code and Codex

Parallel Code is a desktop workspace for running multiple coding agents in parallel. For each task, it creates a git branch and worktree, starts the agent there, and lets you review diffs and merge the result when you are ready.

1,005 stars•131 forks•TypeScript•Updated 7d ago

Meet Parallel Code my new favorite coding tool for working with AI

Super Productivity • 1.3k views • 6 months ago

Who it's for

Builders who want Claude Code, Codex, Gemini CLI, or Copilot running side by side on separate worktrees.

What it delivers

You can let several agents work at once while keeping each change isolated and reviewable.

What it does

Parallel task dispatch

Starts a separate agent session for each task instead of making you wait for one run to finish before starting the next.

Git worktree isolation

Creates a new branch and worktree for every task so changes stay separate from your main branch.

Diff review and merge

Shows the changed files and diffs in the app, then merges the chosen task back to main from the sidebar.

Focus mode and tiled layout

Lets you switch between a multi-task overview and a single-task focus view.

Task notes and canvas

Gives each task its own notes area and live Markdown canvas that can be sent back to the agent.

Shell terminals per task

Opens terminals scoped to the current worktree so you can inspect or run commands in the same context.

Project Docker sandbox

Supports a project-specific `.parallel-code/Dockerfile` so tasks can run inside a controlled environment.

Progress and CI tracking

Tracks task steps, shows status in the UI, and watches GitHub checks for the current branch.

How to get it

1The bundled image still ships the agy binary, and ~/.gemini/antigravity-cli…

git clone https://github.com/johannesjo/parallel-code.git
cd parallel-code
npm install
npm run dev

README

Ten agents.
Ten branches.
One afternoon.

Dispatch AI coding agents in parallel, each in its own worktree.
Review the diffs, merge the wins, toss the rest.

Works with Claude Code, Codex, and Gemini · Every change isolated in its own git worktree · Free, open source, no extra platform fee

License

Parallel Code demo

Screenshots

Multiple agents in parallel	Focused view on a single task

Diff review with inline comments	AI Arena — race agents head-to-head

Why Parallel Code?

Use the AI coding tools you already trust — Claude Code, Codex CLI, Gemini CLI, and Copilot CLI — all from one interface.
Free and open source — no extra subscription required. MIT licensed.
Keep every change isolated and reviewable — each task gets its own git branch and worktree automatically.
Run agents in parallel, not in sequence — five agents on five features at the same time, zero conflicts.
See every session in one place — switch context without losing momentum.
Control everything keyboard-first — every action has a shortcut, mouse optional.
Monitor progress from your phone — scan a QR code, watch agents work over Wi-Fi or Tailscale.
Ask about code with any LLM — the inline code Q&A feature supports Claude Code (default) or MiniMax M2.7 (204K context) — configurable in Settings.

How does it compare?

Approach	What's missing
Multiple terminal windows / tmux	No GUI, no automatic git isolation — you manage worktrees, branches, and merges by hand
VS Code extensions (Kilo Code, Roo Code, etc.)	Tied to VS Code; no true parallel worktree isolation between agents
Running agents sequentially	One task at a time — blocks your workflow while each agent finishes

How it works

When you create a task, Parallel Code:

Creates a new git branch from your main branch
Sets up a git worktree so the agent works in a separate directory
Symlinks node_modules and other gitignored directories into the worktree
Spawns the AI agent in that worktree

When you're happy with the result, merge the branch back to main from the sidebar.

More features

Tiled panel layout with drag-to-reorder
Focus mode — single-task layout with a clean two-column view on wide screens (Ctrl+Shift+F)
Built-in diff viewer with inline review comments and per-commit navigation
Steps tracking panel — engineering-manager-style timeline of agent progress (writes to .claude/steps.json)
Notes panel per task — jot ideas, then send the notes straight to the agent as a prompt
Canvas per task — a Markdown file from the worktree rendered live as the agent writes it; edit it in place, or select a passage and send it to the agent with your question
PR CI status watcher — desktop notification when GitHub checks settle
Shell terminals per task, scoped to the worktree
Direct mode for working on the main branch without isolation, plus support for folders without a git repo
Existing worktree import — bring already-created worktrees into Parallel Code
Sandboxing with project-specific Dockerfiles — drop a .parallel-code/Dockerfile into the project and tasks run inside it
Coverage radar — per-file test-coverage badges in the Changed Files panel
Configurable keyboard shortcuts with per-agent presets
10 themes — Islands Dark, Minimal, Graphite, Midnight, Classic, Indigo, Ember, Glacier, Zenburnesque, Workbench
State persists across restarts
macOS and Linux

Demo

▶ Watch the showcase (MP4)

Getting Started

Download the latest release for your platform from the releases page:
- macOS — .dmg (universal)
- Linux — .AppImage or .deb
Install at least one AI coding CLI: Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, or Copilot CLI
Open Parallel Code, point it at a git repo, and start dispatching tasks.

Antigravity CLI: run natively, not in Docker isolation

Antigravity (agy) signs in interactively and caches credentials in your OS keyring (Keychain/libsecret). The keyring cannot be reached from inside a Linux container — it needs a secret-service daemon the agent container doesn't run — and agy has no API-key fallback, so Docker-isolated Antigravity tasks cannot authenticate. Run Antigravity as a native (non-Docker) task.

The bundled image still ships the agy binary, and ~/.gemini/antigravity-cli (settings/plugins) is shared when "Share agent auth" is enabled, so Docker support is forward-compatible if a file-based or API-key auth path appears later.

Build from source

git clone https://github.com/johannesjo/parallel-code.git
cd parallel-code
npm install
npm run dev

Requires Node.js v18+.

Keyboard Shortcuts

Ctrl = Cmd on macOS.

Shortcut	Action
Tasks
`Ctrl+N`	New task
`Ctrl+Shift+A`	New task (alternative)
`Ctrl+Enter`	Send prompt
`Ctrl+Shift+M`	Merge task to main
`Ctrl+Shift+P`	Push to remote
`Ctrl+W`	Close focused terminal session
`Ctrl+Shift+W`	Close active task
Navigation
`Alt+Arrows`	Focus pane/task in arrow direction
`Alt+Shift+Left/Right`	Move task (macOS: `Ctrl+Shift`)
`Ctrl+B`	Toggle sidebar
`Ctrl+Shift+F`	Toggle focus mode
Terminals
`Ctrl+Shift+T`	New shell terminal
`Ctrl+Shift+D`	New standalone terminal
App
`Ctrl+,`	Open settings
`Ctrl+/` or `F1`	Show all shortcuts
`Ctrl+0`	Reset zoom
`Ctrl+Scroll`	Adjust zoom
`Escape`	Close dialog

If Parallel Code saves you time, consider giving it a star on GitHub. It helps others find the project.

License

MIT

Files in the repo

Repository payload•31 top-level entries

.github— GitHub workflows and templates
.husky— 3 items
.semgrep— 3 items
.vscode— 1 item
build— 12 items
docker— 1 item
docs— Documentation
electron— 20 items
screens— 17 items
scripts— Helper scripts
src— Source code
.dependency-cruiser.cjs
.gitignore
.gitleaks.toml
.npmrc
.prettierignore
.prettierrc
CLAUDE.md— Instructions Claude Code reads every session
eslint.config.js
index.html
install.sh— Install script
knip.config.ts
LICENSE— License
package-lock.json
package.json— Node package: install with npm
PRIVACY.md
README.md— The README
tsconfig.json
vitest.client.config.ts
vitest.config.ts
vitest.setup.ts

Discussion (0)

Ask about usage, or say what you built with it

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/

caveman

JuliusBrussee/cavemanTools

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k

1 add

MemPalace/

mempalace

MemPalace/mempalaceTools

The best-benchmarked open-source AI memory system. And it's free.

59k

stablyai/

orca

stablyai/orcaTools

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k

farion1231/cc-switchTools

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k

diegosouzapw/OmniRouteTools

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k

headroomlabs-ai/

headroom

headroomlabs-ai/headroomTools

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k