https://github.com/johannesjo/parallel-code
Run Claude Code, Codex, and Gemini side by side — each in its own git worktree
https://github.com/johannesjo/parallel-code
ai-agents ai-coding ai-tools claude-code codex-cli coding-agent developer-tools gemini-cli git-worktree terminal
Last synced: 7 days ago
JSON representation
Run Claude Code, Codex, and Gemini side by side — each in its own git worktree
- Host: GitHub
- URL: https://github.com/johannesjo/parallel-code
- Owner: johannesjo
- License: mit
- Created: 2026-02-18T09:53:27.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-02-24T23:26:11.000Z (25 days ago)
- Last Synced: 2026-02-26T23:55:59.704Z (23 days ago)
- Topics: ai-agents, ai-coding, ai-tools, claude-code, codex-cli, coding-agent, developer-tools, gemini-cli, git-worktree, terminal
- Language: TypeScript
- Homepage:
- Size: 49.9 MB
- Stars: 271
- Watchers: 2
- Forks: 21
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ai-dev-tools - Parallel Code - Desktop app that runs multiple AI coding agents (Claude Code, Codex CLI, Gemini CLI) in parallel with automatic git worktree isolation, a unified GUI, and remote monitoring. (📚 Tools / 🌟 What You'll Find Here:)
- awesome-ai-devtools - Parallel Code - Desktop app that runs multiple AI coding agents (Claude Code, Codex CLI, Gemini CLI) in parallel with automatic git worktree isolation, a unified GUI, and remote monitoring. (IDEs)
README
Turn wait time into parallel progress.
**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 |
| ------------------------------------------- | --------------------------------- |
|  |  |
| **Direct mode (main branch)** | **Themes** |
|  |  |
## Why Parallel Code?
- **Use the AI coding tools you already trust** — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex CLI](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/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](https://git-scm.com/docs/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](https://github.com/johannesjo/parallel-code/releases/latest):
- **macOS** — `.dmg` (universal)
- **Linux** — `.AppImage` or `.deb`
2. **Install at least one AI coding CLI:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex CLI](https://github.com/openai/codex), or [Gemini CLI](https://github.com/google-gemini/gemini-cli)
3. **Open Parallel Code**, point it at a git repo, and start dispatching tasks.
Build from source
```sh
git clone https://github.com/johannesjo/parallel-code.git
cd parallel-code
npm install
npm run dev
```
Requires [Node.js](https://nodejs.org/) 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](https://github.com/johannesjo/parallel-code). It helps others find the project.
## License
MIT