parallel-code

How it works

1. Start a task. Describe it and pick an agent. Parallel Code creates a branch and a git worktree, links node_modules and other git-ignored directories into it, and starts the agent there.
2. Start the next one. The Board sorts every task by what it needs from you: Needs you, Stopped, Working, In pull request. Ctrl+Tab jumps to the next task that is waiting for you.
3. Review the diff. Comment on lines and send the comments back to the agent, or ask for a guided tour of what changed.
4. Merge it or toss it. Finish merges the branch or pushes it for a pull request. Closing a task removes its worktree.

That is the core loop. Everything else is optional and stays out of the way until you use it.

Screenshots

Agents working, waiting for input, and ready to merge	One task in focus with its chat, files, notes, and shell
Inline review comments you send back to the agent	A guided tour of what the agent changed
The agent's reasoning graph, updated live	A mind map with branches linked to live tasks

Why Parallel Code?

• Mix the agents you already use — Claude Code, Codex CLI, OpenCode, Copilot CLI, Antigravity CLI, or any other terminal agent, side by side on one board. Each runs as its own CLI, with your own login and plan.
• Review is built in — a diff viewer with inline comments you send back to the agent, guided tours of the changes, and an optional second-opinion review by a separate model, so an agent never grades its own work.
• Every change isolated — each task gets its own branch and worktree, and optionally its own Docker container.
• Free, open source, local — MIT licensed, no account, no extra subscription. Parallel Code has no server of its own: your code goes only to the agent CLIs you run and to the models you choose in Settings.
• Keyboard-first — every action has a shortcut.
• Check in from your phone — scan a QR code to follow and answer your agents over Wi-Fi or Tailscale.

Where it fits

If you use…	Parallel Code adds
Several terminals or tmux	Worktrees, branches and merges handled for you, and one board that shows which agent is waiting for you
One vendor's desktop app (Claude, Codex, Copilot)	Agents from different vendors on the same board, the same review flow for all of them, and an arena to compare them on one task
Another parallel-agent app	Free and MIT licensed with no paid tier, macOS and Linux, a review loop you can send back to the agent, and phone access that connects straight to your computer

When something else fits better: Parallel Code runs agents on your computer, so it is not for agents that keep working in the cloud while your laptop is off.

Demo

Getting started

1. Download the latest release from the releases page:
   • macOS — .dmg (universal, signed and notarized)
   • Linux — .AppImage or .deb
2. Install at least one agent CLI — Claude Code, Codex CLI, OpenCode, Copilot CLI or Antigravity CLI. The welcome screen shows which ones it found.
3. Open Parallel Code, choose a folder with your code (a git repository works best), and start a task.

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

Requires Node.js 22.12 or later. On Windows, the npm scripts use POSIX shell syntax, so run them through Git Bash: npm config set script-shell "C:\Program Files\Git\bin\bash.exe" --location project.

Phone access uses port 8777 in development (npm run dev) and 7777 in the installed app, so both can run together. Run npm run build:remote after changing the mobile UI, then use Connect Phone in the development app to get its connection link or QR code.

Optional features

Each feature is described in docs/features.md.

• Review — inline review comments, a guided tour of the changes, confidence ratings from a separate reviewer model, per-file test coverage, before-and-after screenshots of UI changes, and tours that explain a plan or a file
• Planning — a Kanban project plan kept in KANBAN.md, agents that start and manage their own subtasks, an arena that runs one prompt with two to four agents to compare, a mind map and the agent's live reasoning graph, a live Markdown canvas, notes, and short task briefs
• Running code — shell terminals per task, a browser preview of your local app, per-project Docker sandboxes (not for Antigravity), direct mode without a worktree, folders without git, and importing existing worktrees
• Phone — a phone UI in any mobile browser, an Android app, and notifications when a task needs you. See docs/phone.md
• Integrations — PR CI status notifications, Super Productivity time tracking (an open-source to-do list and time tracker by the same developer), and a choice of model for code Q&A
• Customization — Focus, Tiles and Board layouts, configurable shortcuts, custom agents, and 10 themes

Every action has a keyboard shortcut. Press Ctrl+/ or F1 in the app to see them all, or read the shortcut list.

Contributing

Found a bug or have an idea? Use Settings → General → Report a bug in the app, or open an issue. Pull requests are welcome, including ones written with coding agents; see CONTRIBUTING.md to get started.

---

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

License

MIT