ParallelCode

ParallelCode란?

ParallelCode는 AI 코딩 에이전트를 병렬로 실행해 각 작업을 별도의 git 브랜치와 worktree로 격리하는 데스크톱 앱입니다. 핵심 목적은 여러 터미널 기반 에이전트로 코드를 생성한 후 diff를 검토하고 원하는 변경만 main 브랜치로 병합하는 것입니다.

기존 워크플로와 함께 작동하도록 설계되었습니다: 데스크톱 앱 내에서 에이전트 CLI를 실행하면서 선호하는 IDE가 편집을 담당합니다. Claude Code, Codex CLI, Gemini CLI를 지원하며 작업 생성, 에이전트 출력 모니터링, 결과 병합을 위한 단일 인터페이스를 제공합니다.

주요 기능

• AI 코딩 작업 병렬 실행: 여러 에이전트를 동시에 실행해 한 에이전트 완료를 기다릴 필요 없음.
• 작업별 git worktree 격리: 각 작업에 git 브랜치와 worktree를 생성해 에이전트 실행 간 간섭 방지.
• diff 우선 검토 및 원클릭 병합: diff와 변경 파일 검토 후 사이드바에서 main으로 병합.
• 네이티브 데스크톱 앱에서 실제 터미널 CLI 실행: 웹 기반 추상화 대신 네이티브 환경에서 에이전트 CLI 실행.
• 모든 IDE와 함께 사용 (독립 Electron 앱): ParallelCode가 에이전트 오케스트레이션과 worktree를 처리하며 IDE (VS Code, Cursor, JetBrains, Sublime 등)는 파일 편집 계속.
• 키보드 중심 제어 및 휴대폰 모니터링: 단축키 지원, QR 코드 스캔으로 Wi‑Fi 또는 Tailscale 통해 휴대폰에서 에이전트 터미널 모니터링.
• MIT 라이선스 무료 오픈소스: MIT 라이선스로 다운로드 및 개발 가능, API 키는 사용자 소유 (프록시나 수집 없음).

ParallelCode 사용법

1. GitHub 릴리스 페이지에서 앱 다운로드 및 실행 (macOS .dmg; Linux .AppImage 또는 .deb).
2. 작업 생성 후 에이전트 선택: Claude Code, Codex CLI, Gemini CLI.
3. 격리된 git 브랜치/worktree에서 에이전트 실행. 앱 내 터미널 출력 모니터링.
4. diff 및 변경 파일 뷰로 생성된 변경 검토.
5. 준비되면 사이드바 병합 컨트롤로 main 브랜치에 병합.

사용 사례

• 동일 기능에 여러 에이전트 접근 방식 비교: Claude Code, Codex CLI, Gemini CLI에 별도 작업 실행 후 적합한 diff 검토 및 병합.
• 여러 티켓 반복 시 중단 최소화: 여러 코딩 작업 동시 실행, 각 작업을 git worktree로 격리해 충돌 방지.
• main 적용 전 변경 감사: diff 뷰로 변경 파일 확인 후 결과 검증 시 병합.
• 에디터 워크플로 유지: ParallelCode가 에이전트 실행, 브랜치/worktree 설정, 병합 워크플로 처리하는 동안 기존 IDE에서 편집 계속.
• 장기 실행 에이전트 출력 원격 모니터링: QR 코드와 Wi‑Fi 또는 Tailscale로 휴대폰 모니터링해 책상에서 떨어져도 추적.

자주 묻는 질문

ParallelCode가 내 IDE와 작동하나요?

네. ParallelCode는 에이전트 워크플로 실행과 worktree/브랜치 관리를 하는 독립 Electron 앱입니다. 선호 에디터 (예: VS Code, Cursor, JetBrains, Sublime)로 코드 편집 계속 가능.

어떤 AI 에이전트가 기본 지원되나요?

Claude Code, Codex CLI, Gemini CLI 지원. 터미널에서 작동하는 모든 CLI 기반 코딩 에이전트 사용 가능.

작업 격리 방식은?

각 작업에 git 브랜치와 worktree 생성. 각 에이전트가 자체 디렉터리에서 실행되며, symlinked node_modules 및 기타 gitignore 파일로 격리 지원.

main 브랜치에 변경 적용 방법은?

각 작업에 diff 및 변경 파일 뷰 제공. 만족 시 사이드바에서 main으로 병합.

ParallelCode는 무료인가요?

네. MIT 라이선스 무료 오픈소스이며, API 키는 사용자 소유, 프록시나 수집 없음.

대안

• 여러 터미널과 수동 worktree 관리: 터미널(및 tmux 같은 도구)로 코딩 에이전트를 실행하면 동시성을 달성할 수 있지만, worktree, 브랜치, 병합을 수동으로 관리해야 합니다.
• 멀티 에이전트 워크플로우를 위한 에디터 확장: 일부 VS Code 스타일 확장은 에이전트를 조율할 수 있지만, 단일 에디터 환경에 초점을 맞추고 git worktree 격리 및 병합 워크플로우를 제공하지 않을 수 있습니다.
• 단일 에이전트 순차 실행: 터미널에서 한 번에 하나의 에이전트를 실행하는 건 더 간단하지만, 각 작업이 완료될 때까지 워크플로우가 차단됩니다. 병렬 브랜치 실행 대신요.
• CLI 에이전트와 일반 git 기반 브랜칭 워크플로우: git 브랜치와 터미널 기반 에이전트 실행을 결합할 수 있지만, diff 검토, 원클릭 병합, 통합 모니터링의 UI/지원 기능은 ParallelCode보다 더 수동적입니다.