parallel-code  by johannesjo

AI coding agent orchestration tool

Created 3 weeks ago

New!

362 stars

Top 77.9% on SourcePulse

GitHubView on GitHub
Project Summary

Parallel Code addresses the chaos of running multiple AI coding agents concurrently by providing a unified interface that isolates each agent's work. It targets developers using agents like Claude Code, Codex CLI, and Gemini CLI, offering a streamlined workflow that prevents code conflicts and reduces cognitive load, allowing users to manage multiple AI-assisted development tasks efficiently.

How It Works

The project employs a novel approach using Git worktrees and dedicated branches for each AI agent. Upon task creation, Parallel Code automatically generates a new Git branch from the main branch, establishes a separate worktree for the agent, and symlinks ignored directories to maintain a clean, isolated development environment. This architecture ensures agents operate independently, preventing interference and simplifying the merging of completed features back into the main codebase.

Quick Start & Requirements

Installation involves downloading a pre-built release for macOS (.dmg) or Linux (.AppImage, .deb), or building from source via npm install and npm run dev after cloning the repository. Users must have Node.js v18+ installed and at least one supported AI coding CLI (Claude Code, Codex CLI, or Gemini CLI) pre-installed. The application supports macOS and Linux.

Highlighted Details

  • Integrates Claude Code, Codex CLI, and Gemini CLI within a single interface.
  • Achieves zero conflicts across up to five agents by assigning each a dedicated Git branch and worktree.
  • Enables remote monitoring of agent terminals via a QR code, allowing users to step away from their desk.
  • Features a keyboard-first design with extensive shortcuts for navigation, task management, and Git operations.
  • Includes a tiled panel layout, built-in diff viewer, and six distinct visual themes.

Maintenance & Community

The provided README does not contain specific details regarding maintainers, community channels (like Discord or Slack), sponsorships, or project roadmaps.

Licensing & Compatibility

Parallel Code is released under the MIT license, which is highly permissive and generally compatible with commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The tool is specifically designed for integration with Claude Code, Codex CLI, and Gemini CLI, requiring these external CLIs to be installed separately. Building from source necessitates Node.js version 18 or higher.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
10
Issues (30d)
8
Star History
365 stars in the last 23 days

Explore Similar Projects

Feedback? Help us improve.