はじめに

最初のセッション

ダッシュボードのガイドツアー — 空のワークスペースから、最初の Claude セッションを起動・モニタリングするまで。

purplemux はすでに動作している前提です (まだなら クイックスタート を参照)。このページでは UI が実際に何をするのかを順に解説し、最初の数分の抽象度を下げます。

ダッシュボード

http://localhost:8022 を開くと、ワークスペース に着地します。ワークスペースは関連タブをまとめたフォルダのようなものです — Claude でコーディングしているプロジェクト用、ドキュメントを書くためのもの、アドホックなシェル作業用、といった形です。

レイアウト:

  • 左サイドバー — ワークスペースとセッション、Claude ステータスバッジ、レート制限ウィジェット、ノート、統計
  • メインエリア — 現在のワークスペース内のペイン。各ペインは複数のタブを持てます
  • トップバー — ワークスペース名、分割コントロール、設定

サイドバーは ⌘B でいつでも切り替えられます。サイドバーの ワークスペース / セッション モード切り替えは ⌘⇧B です。

ワークスペースを作る

初回起動時にデフォルトのワークスペースが 1 つ用意されます。追加するには:

  1. サイドバー上部の + 新しいワークスペース をクリック (⌘N)。
  2. 名前とデフォルトディレクトリを指定 — これが新しいタブのシェル開始位置になります。
  3. Enter を押すと、空のワークスペースが開きます。

ワークスペースは後からサイドバー上でドラッグして並び替え・名前変更できます。

最初のタブを開く

ワークスペースは空の状態で始まります。⌘T またはタブバーの + ボタンでタブを追加します。

テンプレート を選択:

  • Terminal — 空のシェル。vimdocker、スクリプト用に。
  • Claudeclaude がすでに実行された状態で起動。
テンプレートはただのショートカット
内部的にはどのタブも普通のシェルです。Claude テンプレートは「ターミナルを開いて `claude` を実行する」だけのもの。後から Terminal タブで手動で `claude` を実行しても、purplemux はそれを認識して同じ方法でステータスを表示します。

セッションステータスを読む

タブの サイドバーセッション行 を見てください。次のいずれかのインジケータが表示されます:

状態 意味
アイドル (グレー) Claude があなたの入力を待っています。
ビジー (パープルのスピナー) Claude が作業中 — ファイル読込、ツール実行など。
入力待ち (アンバー) Claude が権限プロンプトに到達したか、質問しています。
レビュー (ブルー) 作業完了、Claude は停止。確認すべきものがあります。

遷移はほぼ瞬時です。検出方法は セッションステータス を参照してください。

権限プロンプトに応答する

Claude がツール実行やファイル編集の許可を求めると、purplemux はプロンプトをインターセプトして セッションビュー内にインラインで表示します。次のいずれかで応答できます:

  • 1 · はい / 2 · 常にはい / 3 · いいえ をクリック
  • キーボードの数字キーを押す
  • 無視してスマートフォンで答える — モバイル Web Push が同じアラートを発火します

Claude CLI 自体はインターセプトされたプロンプトでブロックされ続けることはありません。purplemux があなたの回答を返してくれます。

分割と切り替え

タブが起動したら試してみてください:

  • ⌘D — 現在のペインを右に分割
  • ⌘⇧D — 下に分割
  • ⌘⌥←/→/↑/↓ — 分割間でフォーカス移動
  • ⌘⇧[ / ⌘⇧] — 前 / 次のタブ

すべては キーボードショートカット のページにまとめてあります。

保存と復元

ブラウザを閉じてください。タブはどこにも行きません — tmux がサーバ上で開いたままにします。1 時間後 (あるいは 1 週間後) にリフレッシュすると、purplemux は分割比率や作業ディレクトリも含めた完全なレイアウトを復元します。

サーバ再起動からも復旧可能です: 再起動時に purplemux は ~/.purplemux/workspaces.json から保存されたレイアウトを読み込み、シェルを正しいディレクトリで再起動し、可能な限り Claude セッションを再アタッチします。

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

実行:

tailscale serve --bg 8022

スマートフォンで https://<machine>.<tailnet>.ts.net を開き、共有 → ホーム画面に追加 をタップして通知の許可を与えます。これで、タブを閉じていても 入力待ちレビュー のステータスでプッシュアラートを受け取れます。

詳しい手順: PWA セットアップ · Web Push · Tailscale

次のステップ