The Problem
AI coding agents like Claude Code, Codex, and Gemini CLI are powerful, but running them sequentially wastes time, and running them in parallel without isolation creates git conflicts. Developers need a way to run multiple agents simultaneously, each on its own branch, with a clean review and merge workflow.
What This Does
Parallel Code is an Electron desktop app that wraps multiple AI coding agents in isolated git worktrees. When you create a task, it creates a branch, sets up a git worktree, symlinks gitignored directories like node_modules, and spawns the agent in that worktree. The electron/ipc/ directory handles the agent spawning, git operations, and terminal sessions via PTY (electron/ipc/pty.ts).
The UI is a SolidJS React-style app (src/App.tsx) with a tiled panel layout, keyboard-first controls, a diff viewer, and phone monitoring over Wi-Fi or Tailscale (src/components/ConnectPhoneModal.tsx). An "arena mode" (src/arena/) lets you pit agents against each other on the same task and compare results. The app also supports inline code Q&A via Claude Code or MiniMax.
How To Use It
Setup: The repo uses npm (package.json, package-lock.json present). No install script is documented in the README excerpt.
Configuration: No environment variables are required. Agent selection and settings are configured within the app's Settings dialog (src/components/SettingsDialog.tsx).
Running it: The app is an Electron application. The main entry point is electron/main.ts, with the UI bootstrapped from src/index.tsx. A Dockerfile exists (docker/Dockerfile) for containerized builds, but no run command is documented.
Typical Electron app workflow (not explicitly documented in README) npm install npm start
Real-World Use
A developer with a feature-heavy sprint creates five tasks in Parallel Code, each with a different agent (Claude Code, Codex, Gemini). Each agent works in its own worktree on its own branch. The developer watches progress from a single dashboard, reviews diffs in the built-in viewer, and merges branches back to main when ready. The phone monitoring feature lets them check status while away from the desk.
Code Health & Issues
Med - Potential race conditions: The electron/ipc/ handlers manage multiple concurrent agent processes and git operations. The codebase has tests (electron/ipc/pty.test.ts, electron/ipc/git.test.ts), but concurrency edge cases are hard to fully cover. Low - Platform limitation: The README states macOS and Linux only. Windows users are excluded, and the build/entitlements.mac.plist confirms macOS-specific packaging. Low - Missing documentation: Only 2 doc files found. The README covers features but not troubleshooting, architecture, or contribution guidelines. Low - Dependency size: The package-lock.json is large; Electron apps with this many dependencies (React, Monaco editor, Docker integration) will have a heavy install footprint.
The repo has CI (github/workflows/ci.yml), release automation (release.yml), a license, and 27 test files. No obvious secrets or config files are committed.
The Bottom Line
Parallel Code solves a real pain point for developers who use multiple AI agents and want to run them concurrently without git chaos. The architecture is sound, with proper isolation via worktrees and a solid test suite. It's best suited for macOS/Linux users who are comfortable with keyboard-driven workflows and are already using Claude Code, Codex, or Gemini CLI. The lack of Windows support and minimal documentation are the main limitations.