Skip to content

johannesjo/parallel-code

Parallel Code

Turn wait time into parallel progress.

Electron SolidJS TypeScript macOS | Linux License

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 task Commit & merge workflow
Agent working Workflow
Direct mode (main branch) Themes
Direct mode Themes

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?
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:

  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

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.

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

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

License

MIT

About

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

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Languages