Mac Parallel Accelerator

Codex가 macOS에서 빌드, 테스트, Docker, 연구 파이프라인을 더 빠르게 완료하도록 하세요—작업 의미론을 깨지 않으면서.

中文说明 · 라이브 보고서 · 첫 실행 보고 · 벤치마크 공유

두 개의 명령으로 설치

codex plugin marketplace add cloudguo123/mac-parallel-accelerator
codex plugin add mac-parallel-accelerator@mac-parallel-accelerator

새 Codex 작업을 열고 다음을 요청하세요:

Use $accelerate-local-work to inspect this project and run the safe parts in parallel.
Keep progress visible and report time saved for this run and cumulatively.

요구 사항: macOS, 플러그인 및 MCP를 지원하는 Codex, Python 3.10 이상. Ruby는 Compose YAML 분석에만 필요하며, Node.js 20+는 브라우저 표시기를 다시 빌드할 때만 필요합니다.

이 저장소는 또한 루트 plugin.json, skills/, 그리고 local-stdio mcp.json을 통해 벤더 중립적인 Agent Plugins 1.0.0 패키지 구조를 따릅니다. Codex 네이티브 클라이언트는 계속해서 .codex-plugin/plugin.json 및 .mcp.json을 사용합니다.

Related MCP server: claude-code-codex-agents

존재 이유

대부분의 "병렬" 래퍼는 명령 텍스트를 분할하고 잘되기를 바랍니다. 이는 &&/||의 순서를 바꾸고, .next, JUnit, 데이터베이스, Docker 볼륨 또는 Git 상태를 경쟁 상태로 만들며, 중첩된 워커 풀을 배가시키고, 실패를 끝까지 숨길 수 있습니다.

Mac Parallel Accelerator는 먼저 요청된 작업을 타입이 지정된 Atom IR로 컴파일합니다. 독립적임이 입증된 원자만 동시 실행이 허용됩니다. 알 수 없는 효과, 모호한 작성자, 오래된 소스 스냅샷, 지원되지 않는 수명 주기 이벤트, 변경된 계획은 모두 차단(fail closed)됩니다.

shell · package scripts · Make · Compose · tests · builds · declared work
                              │
                              ▼
             static frontends → typed Atom IR
                              │
                              ▼
        conflict checks → resource-aware event scheduler
                              │
                              ▼
              exact verified execution + live savings

가속 대상

시나리오 카탈로그에는 소프트웨어, 연구, 컨테이너, 미디어, ML, 릴리스, 데이터베이스, 저수준 CPU/GPU/I/O 작업을 다루는 50개 이상의 프리셋이 포함됩니다.

실시간 실행—빈 스피너가 아님

장시간 실행은 PTY 기반 러너를 사용하며 다음을 지속적으로 표시합니다:

elapsed 2m 15s · running 4 · ready 2 · completed 7 · failed 0
estimated saved this run 4m 31s · cumulative saved 19m 52s

완료 시 모든 원자의 상태, 반환 코드, 타임아웃, 건너뛴 이유, 출력 잘림, 최대 동시성, 실행별 절감, 누적 절감이 확인됩니다.

5분 벤치마크

보존된 공개 실행은 실제 병렬 실행기를 통해 네 가지 격리된 저부하 워크로드를 실행했습니다. 모든 작업은 최소 5분 동안 실행되었습니다.

직렬 환산 시간은 관측된 독립 작업 실행 시간의 합계이며, 별도로 실행된 직렬 실행이 아닙니다. 이는 통제된 독립 작업에서 스케줄러 오버헤드와 보고 동작을 보여줄 뿐, 모든 프로젝트가 4배 빨라진다는 보편적인 주장은 아닙니다. 시각적 보고서, 원본 근거, 벤치마크 프로토콜을 참조하세요.

실행 계약

안전 핸드셰이크는 의도적으로 엄격합니다:

atomic_task_plan
  → complete immutable compiled_plan + plan_hash
  → atomic_exec with that exact object and hash

계획은 수작업으로 작성된 웨이브나 일반적인 DAG 호출로 다시 변환되지 않습니다. 타입이 지정된 제어 엣지는 성공, 실패, 순서, 데이터, 스트림, 준비 상태, 헬스, 완료, 정리를 구분합니다. 아티팩트, 파일 외 효과, 용량 리소스, 수명 주기 이벤트, 소스 스냅샷은 실행 계약의 일부로 계속 남습니다.

개인정보 보호 및 권한 부여

• 프로젝트 및 선택적 추적 검사는 로컬에서 제한적으로 수행됩니다.

• 추적 분석은 프롬프트, 추론, 명령 본문 또는 도구 출력이 아닌 집계된 라우팅 신호를 반환합니다.

• 병렬 처리는 타이밍을 변경할 뿐 권한은 절대 변경하지 않습니다. 계획 수립은 새 명령, 원격 변경, 파괴적 정리, 재시도를 승인하지 않습니다.

• 실행 결과는 자동으로 업로드되지 않습니다. 공유는 명시적이며 검토 가능합니다.

• 타임아웃은 프로세스 그룹을 종료하며, 타임아웃된 부작용은 알 수 없는 것으로 간주되어 자동으로 재시도되지 않습니다.

위협 모델 및 신고 절차는 SECURITY.md를 참조하세요.

개발

python3 -m py_compile scripts/*.py
python3 -m unittest discover -s scripts -p 'test*.py' -v
python3 scripts/self_test.py
uvx ruff check scripts
npm ci && npm run build:indicator

공개 검증 및 공유 자산 생성:

python3 scripts/generate_test_report.py
python3 scripts/generate_growth_assets.py
python3 scripts/render_growth_media.py  # optional PNG/GIF, requires Chrome + ffmpeg

유용한 참고 자료:

• 아키텍처 및 안전 불변식

• Atom IR 참조

• 벤치마크 및 외부 결과 프로토콜

• 기여하기

• 릴리스 기록

성장을 돕기

하나의 실제 작업에 적용해 본 다음, 정리된 결과 카드를 공유하거나 벤치마크를 제출하세요. 플래너가 안전해야 할 작업을 차단한다면, 그 보고서는 속도 향상만큼이나 가치가 있습니다. 다음에 누락된 의미 규칙을 식별해 주기 때문입니다.

첫 실행 보고하기 · 벤치마크 보고서 열기 · 질문하기 · 로드맵 보기

MIT 라이선스 · 개인정보 처리방침 · 약관