Skip to content

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

License

Notifications You must be signed in to change notification settings

hufeng/parallel-code

 
 

Repository files navigation

Parallel Code

Run multiple AI coding agents side by side, each in their own isolated git worktree and monitor from your phone.

Electron SolidJS TypeScript macOS | Linux License

Parallel Code demo

Parallel Code lets you dispatch tasks to AI coding agents — Claude Code, Codex CLI, or Gemini CLI — and watch them work simultaneously. Each task gets its own git branch and worktree, so agents never step on each other's code. When a task is done, merge it back to main with one click.

Screenshots

Agent working on a task Commit & merge workflow
Agent working Workflow
Direct mode (main branch) Themes
Direct mode Themes

Parallel Code in action

Features

One app for every AI coding CLI

Use Claude Code, Codex CLI, and Gemini CLI from the same interface. Switch between agents per task, or run all three at once — no juggling terminal windows.

Automatic branches and worktrees

Every task gets its own git branch and worktree instantly. Agents work in full isolation — no conflicts, no stashing, no waiting. Five agents, five features, one repo. Merge back to main when you're done.

Monitor from your phone

Scan a QR code and watch all your agent terminals live on your phone — over Wi-Fi or Tailscale. Step away from your desk while your agents keep working.

Keyboard-first, zero friction

Navigate panels, create tasks, send prompts, merge branches, push to remote — all without touching the mouse. Every action has a shortcut, and Ctrl+/ shows them all.

And more

  • 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

Download

Grab the latest release for your platform from the releases page:

  • macOS.dmg (universal)
  • Linux.AppImage or .deb

Getting Started

Prerequisites

Install & Run

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

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

This means you can have five agents working on five different features at the same time, all from the same repo, with zero conflicts. When you're happy with the result, merge the branch back to main from the sidebar.

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 Navigate between panels
Ctrl+Alt+Left/Right Reorder active task
Ctrl+B Toggle sidebar
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

License

MIT

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 94.2%
  • CSS 4.1%
  • Other 1.7%