wmux – AIエージェントのためのADE（Agent Development Environment）

概要

wmux は、tmux風のペインレイアウトで複数のAIエージェント用コマンドラインツール（Claude Code、Codex、Geminiなど）を並行実行できるデスクトップアプリケーション（Windows / macOS）です。バックグラウンドデーモンが各ペインをUI終了後や再起動後も維持し、iPhoneアプリからエージェントの対話プロンプトに応答できます。

基本コンセプト

コンセプト	wmuxでの実装
任意のCLIベースAIエージェントを実行	各エージェントは独自のPTY（WindowsではConPTY、macOSではforkpty）で実行されます。WindowsでWSLは不要です。
セッション永続化	デーモンがPTYを所有します。UIを閉じたりクラッシュしてもプロセスは実行され続け、再起動時にペインは正確に会話を再開できます。
スマホでの承認	iPhoneクライアントがデーモンとペアリングします（Tailscale上のHTTPS）。エージェントが質問（例：Claude Codeの権限）をすると、プロンプトが電話の受信トレイに表示され、回答がペインに送信されます。
Git worktreeへのファンアウト	1つのプロンプトを最大8つの独立したタスクに分割できます。各タスクは `wtask/*` ブランチに独自のGit worktree、独自のペインを持ち、単一のコミットとして適用する前に差分をハンク単位でレビューできます。
組み込みブラウザ自動化	エージェントはChrome DevTools Protocolを介して、組み込みブラウザペインまたは実際のChromeインスタンスを制御できます。記録したフローは再生可能です。
Fleetビュー	グローバルな注意リスト（`⌘⇧A` / `Ctrl+Shift+A`）は、ワークスペース全体のすべてのエージェントを表示し、あなたが必要、レビュー準備完了、実行中、アイドルでグループ化します。
Git統合	サイドレールにIssue/PRが表示され、開く、コメント、CIの再実行、アイテムをペインにドラッグしてエージェントに渡すことができます。

主な機能（クイックビュー）

クロスプラットフォーム: ネイティブWindows 10/11およびmacOS Apple-Siliconビルド（実験的なLinux AppImage/.deb/.rpm）。
iPhoneコンパニオン – 質問への回答、受信トレイの確認、オプションのプッシュ通知（シール封筒）。
Worktreeファンアウト – 並列タスク用のGit worktreeの自動作成と、視覚的なdiffレビューUI。
ブラウザペイン – 組み込みのターミナルベースのブラウザ、またはエージェントごとの専用Chromeタブ。フローの記録・再生が可能。
エージェント間メッセージング – ペインは互いにメッセージを送信できます（send_message）。
使用量制限の処理 – 割り当てが尽きるとエージェントは一時停止します。オプションの リセット時に再開 で自動的に再起動します。
デーモン管理セッション – 終了、クラッシュ、再起動後も存続。ペインは監視され、自動再起動されます。
リモート読み取り専用ビュー – wmux web はライブペインをブラウザに提供します（デフォルトではループバックのみ）。
拡張可能なCLIとAPI – wmux CLIをスクリプト化するか、トークン認証付きソケットを介して接続し、イベントに反応できます。
キーボード駆動UI – tmuxスタイルの分割、ワークスペース、コマンドパレット、完全に設定可能なショートカット。

対象ユーザー

開発者: コード生成エージェント（Claude Code、Codex、Gemini）に依存し、安定したマルチペインワークスペースが必要な方。
チーム: 再起動後も長時間実行されるエージェントセッションを維持し、スマホからアクションを承認する必要があるチーム。
研究者: マルチエージェントパイプラインを実験し、プロンプトを並列Git worktreeにファンアウトする方法を必要とする方。
パワーユーザー: ターミナルマルチプレクサが好きだが、組み込みのブラウザ自動化とGitHub統合も欲しい方。

始め方

インストール – winget install openwong2kim.wmux（Windows）または署名付き.dmgをダウンロード（macOS）。
実行 – UIが起動し、バックグラウンドでデーモンが開始します。
エージェントを追加 – ピッカーからCLIエージェント（Claude Code、Codex、Geminiなど）を選択すると、ペインが開きます。
iPhoneをペアリング – Remote → Share & pair を開き、Tailscale上のHTTPSを有効にし、iOSアプリでQRコードをスキャンします。
タスクを作成 – プロンプトを入力し、Fan-out を選択（最大8つのworktree）、次に差分をレビューして適用します。

ソースからのビルド（コントリビューター向け）

git clone https://github.com/openwong2kim/wmux.git
cd wmux
npm install          # Node 18+、Python 3、ネイティブツールチェーン
npm start            # 開発モード
npm run make         # インストーラーパッケージ

プロジェクトはElectron、xterm.js、node-pty、Playwrightを使用してテストされています。

ライセンスと安全性

MITライセンス – 自由に使用・変更できます。
デーモンはインストールしたエージェントCLIのみを実行します。各プロバイダーの利用規約に従う責任はあなたにあります。
電話とデーモン間の通信はトークン認証と暗号化により保護され、プッシュ通知はリレーが内容を読めないように封印されています。

wmuxはAIエージェントのオーケストレーションに焦点を当てた本格的なソフトウェアプロジェクトであり、AIエージェント開発環境の分野に完全に適合します。

openwong2kim/wmux