Mac Parallel Accelerator

Codex が macOS 上でビルド、テスト、Docker、研究パイプラインを、タスクのセマンティクスを壊すことなく高速に完了できるようにします。

中文说明 · ライブレポート · 初回実行を報告 · ベンチマークを共有

2つのコマンドでインストール

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以上はブラウザインジケータを再ビルドする場合にのみ必要です。

このリポジトリはまた、ベンダー中立の Agent Plugins 1.0.0 パッケージレイアウトに、ルートの plugin.json、skills/、および local-stdio の mcp.json を通じて準拠しています。Codexネイティブのクライアントは引き続き .codex-plugin/plugin.json と .mcp.json を使用します。

Related MCP server: BoundedRelay

なぜこれが存在するのか

ほとんどの「並列」ラッパーはコマンド文字列を分割して、うまくいくことを願うだけです。その結果、&&/|| の順序が入れ替わり、.next、JUnit、データベース、Dockerボリューム、Gitの状態で競合が発生し、入れ子のワーカープールが増え、失敗が最後まで隠される可能性があります。

Mac Parallel Accelerator は、まず要求された作業を型付けされた Atom IR にコンパイルします。独立していることが証明されたアトムだけが並行に許可されます。未知の副作用、曖昧な書き込み元、古いソーススナップショット、未対応のライフサイクルイベント、変更された計画は、フェイルクローズ（安全側に倒れて失敗）します。

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分間ベンチマーク

保存済みの公開実行では、実際の並列エグゼキュータを使用して4つの分離された低負荷ワークロードを実行しました。各タスクは少なくとも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 リファレンス

• ベンチマークと外部結果のプロトコル

• コントリビューション

• リリース履歴

成長を支援する

実際のタスクで1回試し、サニタイズした結果カードを共有するか、ベンチマークを提出してください。プランナーが安全であるべき作業をブロックした場合、その報告は高速化と同じくらい価値があります。次の欠落しているセマンティクスルールを特定できるからです。

初回実行を報告 · ベンチマークレポートを開く · 質問する · ロードマップを見る

MITライセンス · プライバシー · 利用規約