PARALLEL-CODE(1)

NAME

parallel-codeRun Claude Code, Codex, and Gemini side by side — each in its own git worktree

SYNOPSIS

$https://github.com/johannesjo/parallel-code/releases

INFO

494 stars
60 forks
0 views

DESCRIPTION

Run Claude Code, Codex, and Gemini side by side — each in its own git worktree

README

Parallel Code

Turn wait time into parallel progress.

Electron SolidJS TypeScript macOS | Linux License

Watch intro on YouTube

Parallel Code demo

Parallel Code is a desktop app that gives every AI coding agent its own git branch and worktree — automatically.

Screenshots

Agent working on a taskCommit & merge workflow
Agent workingWorkflow
Direct mode (main branch)Themes
Direct modeThemes

Why Parallel Code?

  • Use the AI coding tools you already trustClaude Code, Codex CLI, Gemini 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.
How does it compare?
ApproachWhat's missing
Multiple terminal windows / tmuxNo 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 sequentiallyOne task at a time — blocks your workflow while each agent finishes

How it works

When you create a task, Parallel Code:

  1. Creates a new git branch from your main branch
  2. Sets up a git worktree so the agent works in a separate directory
  3. Symlinks node_modules and other gitignored directories into the worktree
  4. 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
  • Built-in diff viewer and changed files list per task
  • Shell terminals per task, scoped to the worktree
  • Direct mode for working on the main branch without isolation
  • Six themes — Minimal, Graphite, Classic, Indigo, Ember, Glacier
  • State persists across restarts
  • macOS and Linux

Demo

Getting Started

  1. Download the latest release for your platform from the releases page:

    • macOS.dmg (universal)
    • Linux.AppImage or .deb
  2. Install at least one AI coding CLI: Claude Code, Codex CLI, or Gemini CLI

  3. Open Parallel Code, point it at a git repo, and start dispatching tasks.

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.

ShortcutAction
Tasks
Ctrl+NNew task
Ctrl+Shift+ANew task (alternative)
Ctrl+EnterSend prompt
Ctrl+Shift+MMerge task to main
Ctrl+Shift+PPush to remote
Ctrl+WClose focused terminal session
Ctrl+Shift+WClose active task
Navigation
Alt+ArrowsNavigate between panels
Ctrl+Alt+Left/RightReorder active task
Ctrl+BToggle sidebar
Terminals
Ctrl+Shift+TNew shell terminal
Ctrl+Shift+DNew standalone terminal
App
Ctrl+,Open settings
Ctrl+/ or F1Show all shortcuts
Ctrl+0Reset zoom
Ctrl+ScrollAdjust zoom
EscapeClose dialog

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

License

MIT

SEE ALSO

clihub3/20/2026PARALLEL-CODE(1)