はじめに

クイックスタート

Node.js と tmux があれば 1 分で purplemux を起動できます。

purplemux はウェブネイティブのマルチプレクサです。すべての Claude Code セッションを 1 つのダッシュボードで管理し、tmux でセッションを永続化し、デスクからでもスマートフォンからでも使えるよう設計されています。

始める前に

purplemux をホストするマシンには 2 つのものが必要です。

  • Node.js 20 以上 — node -v で確認。
  • tmux — tmux -V で確認。3.0 以上であれば OK。
macOS / Linux のみ
Windows は公式にはサポートしていません。purplemux は `node-pty` と tmux に依存しており、これらは Windows ネイティブでは動作しないためです。WSL2 では大抵動きますが、テスト対象外です。

実行

コマンド 1 つ。グローバルインストールも不要です。

npx purplemux

8022 ポートで purplemux が起動します。ブラウザで開いてください。

http://localhost:8022

初回起動では、パスワードの設定と最初のワークスペース作成までが案内されます。

永続的にインストールしたい場合は `pnpm add -g purplemux && purplemux` でも同じように動きます。アップデートは `pnpm up -g purplemux` 1 回で済みます。

Claude セッションを開く

ダッシュボードで:

  1. 任意のワークスペースで 新しいタブ をクリックします。
  2. Claude テンプレートを選ぶか、普通のターミナルで claude を実行します。
  3. purplemux が実行中の Claude CLI を検出し、ステータス・ライブタイムライン・権限プロンプトをリアルタイムに表示し始めます。

ブラウザを閉じてもセッションは維持されます — tmux がサーバ上でプロセスを生かし続けるためです。

スマートフォンから接続する

デフォルトでは purplemux は localhost のみで待ち受けます。安全に外部からアクセスするには Tailscale Serve を使ってください (WireGuard + 自動 HTTPS、ポートフォワーディング不要):

tailscale serve --bg 8022

スマートフォンで https://<machine>.<tailnet>.ts.net を開き、共有 → ホーム画面に追加 をタップすれば、purplemux が PWA としてインストールされ、バックグラウンドでも Web Push 通知を受け取れます。

詳細は Tailscale アクセス を、iOS / Android 固有の手順は PWA セットアップ を参照してください。

次のステップ