複数の AI エージェントを PTY セッション化して daemon 化する Rust 製 CLI multiplexer。tmux ライクな attach/detach、LAN/cloud 越しに iOS/PWA からも操作可能。

amux (jordanwebster/amux)#

要点: amux は tmux 相当の prefix (Ctrl-a d) で detach できる AI agent multiplexer。1 マシン上で複数の Claude Code セッションを並列 daemon 化し、amux list で一覧、amux attach で復帰する。iOS/PWA から LAN 直結または cloud 経由で操作できる。v0.4.0 は agent_type = claude のみ production 対応。

基本コマンド (v0.4.0)#

amux init                          # 初回セットアップ (cloud 認証もここ)
amux server start                  # daemon 起動 (--foreground で前景固定)
amux server stop                   # daemon 停止 + 全セッション終了
amux new claude --name foo         # 新セッション作成
amux new claude -- --model sonnet  # `--` 以降は agent (claude CLI) に渡す
amux list                          # 全ホストの走行中セッション
amux attach foo                    # detach したセッションに復帰
amux update                        # 自己更新

セッション中の detach は Ctrl-a d (tmux prefix と同じ)。

ペアリング (device 間接続)#

amux pair --qr                    # QR payload を表示 (相手側で --qr <payload>)
amux pair --connect <target>      # PIN 方式で相手に接続
amux pair --listen                # LAN 直結レスポンダ (tcp_port 設定必須)
amux pair --via-ssh <target>      # SSH 越しにペアリング + SSH runtime link 保存
amux peer list                    # 信頼済み peer 一覧
amux peer info <peer>             # 個別詳細
amux unpair <peer>                # 信頼取り消し

iOS アプリ (App Store ID: 6760197635) は pair --qr の payload で登録する。

Cloud server モード #

自前のクラウド VM で cloud server を立てる場合:

export AMUX_TLS_CERT=/path/to/cert.pem
export AMUX_TLS_KEY=/path/to/key.pem
amux server start --cloud

TLS 必須 (未設定なら起動失敗、TLS handshake timeout 検知あり)
routing token 検証、user id claim 必須
内部通信は gRPC (/amux.v1.ClientService/*)
- CreateAgent, SubscribeSession, PairQrCloudPeer, PairPinCloudPeer, Unpair, GetPeer
cloud routing のフロントに /api/connect 経路あり

エージェント種別 #

amux new <AGENT_TYPE> で受け付けるのは:

claude — production (Claude Code CLI をラップ)
test-agent — dev build 専用

公式サイトは Codex 対応も謳うが、CLI 引数として v0.4.0 で選べるのは claude のみ。

config #

--config <CONFIG> で YAML 明示指定可能
既定パスは docs 未記載。amux init の対話出力で確認する
インストール先: ~/.amux/bin/amux (installer が ~/.bashrc 等に PATH 追記、fish は手動 fish_add_path -U ~/.amux/bin)

内部構成 (binary strings より)#

Rust 実装、非同期 stack: tonic (gRPC) + hyper + rustls + portable-pty
セッションは portable-pty で PTY を張って daemon が保持 → detach 後も生存
ペアリング資格情報は trusted peer テーブルとして保持 (peer info で参照)

想定ユースケース #

長時間走らせるエージェントジョブを detach し、翌朝 amux attach して結果確認
複数エージェントを別セッションで並列に走らせ、後で attach して介入
mobile / 別端末から pair 越しに走行状態を監視

未検証 (公式サイト記載だが binary で直接は確認できず)#

self-healing watchdog / クラッシュ復旧の具体的動作
コスト追跡の UI 実体 (CLI にはコマンドなし → PWA/iOS 側とみられる)
カンバンボード (dashboard 側の機能)

これらは PWA ダッシュボードまたは iOS アプリ側の機能と考えられる。CLI 単独では確認不可。

amux (jordanwebster/amux)