ワークスペース & ターミナル

ワークスペースとグループ

関連タブをワークスペースに整理し、サイドバーのドラッグ&ドロップ可能なグループでまとめる方法。

ワークスペースは関連タブをまとめたフォルダ — 1 つのプロジェクトのターミナル、diff パネル、Claude セッションが一緒に並びます。複数のワークスペースを持つようになったら、サイドバーのグループを使えばすっきり整理できます。

ワークスペースに含まれるもの

各ワークスペースは独自に以下を持ちます:

  • デフォルトディレクトリ — 新しいタブのシェルが開始する場所。
  • タブとペイン — ターミナル、Claude セッション、diff パネル、Web ブラウザパネル。
  • レイアウト — 分割比率、フォーカス、各ペインのアクティブタブ。

すべては ~/.purplemux/workspaces.json に永続化されるため、ワークスペースは purplemux が保存・復元する単位になります。ブラウザを閉じてもワークスペースは消えません。tmux がシェルを開いたままにし、レイアウトはそのまま残ります。

ワークスペースを作成する

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

  1. サイドバー上部の + 新しいワークスペース をクリックするか、⌘N を押す。
  2. 名前とデフォルトディレクトリ — 通常はそのプロジェクトのリポジトリルート — を指定。
  3. Enter で空のワークスペースが開きます。
正しい開始ディレクトリを選ぶ
デフォルトディレクトリはこのワークスペース内で開く新しいシェルすべての cwd になります。プロジェクトのルートを指定しておけば、新しいタブを開いた瞬間に `pnpm dev`、`git status`、または正しい場所で Claude セッションを開始できます。

名前変更と削除

サイドバーでワークスペースを右クリック (またはケバブメニュー) して 名前変更 または 削除 を選びます。現在アクティブなワークスペースの名前変更は ⌘⇧R でも可能です。

ワークスペースを削除すると、その tmux セッションが閉じられ、workspaces.json から取り除かれます。元に戻せません。すでにクラッシュしたタブや閉じられたタブはそのまま消えたままです。生きているタブはきれいに kill されます。

ワークスペースを切り替える

サイドバーで任意のワークスペースをクリックするか、数字キーを使います:

アクション macOS Linux / Windows
ワークスペース 1〜9 に切り替え ⌘1⌘9 Ctrl+1Ctrl+9
サイドバー切り替え ⌘B Ctrl+B
サイドバーモード切替 (ワークスペース ↔ セッション) ⌘⇧B Ctrl+Shift+B

サイドバーの順序が数字キーのマッピング順になります。スロットを変更するには、ワークスペースを上下にドラッグしてください。

ワークスペースをグループ化する

ワークスペースが増えてきたら、サイドバーでドラッグ&ドロップしてグループに入れることができます。グループは折り畳み可能なヘッダで、「クライアント業務」「サイドプロジェクト」「運用」などを 1 つのフラットなリストに無理やり並べずに分けるのに便利です。

  • グループを作成 — 1 つのワークスペースを別のワークスペースにドラッグすると、サイドバーがグループ化を提案します。
  • 名前変更 — グループヘッダを右クリック。
  • 並び替え — グループを上下にドラッグ、ワークスペースを出し入れ。
  • 折り畳み — グループヘッダのシェブロンをクリック。

グループは見た目の整理用です。タブの永続化やショートカットの動作には影響しません。⌘1⌘9 はグループ関係なく、フラットな順序で上から下へ走ります。

ディスク上の配置

すべての変更は ~/.purplemux/workspaces.json に書き込まれます。確認やバックアップが可能です — ファイルレイアウト全体は データディレクトリ を参照してください。サーバの実行中にこのファイルを消去すると、purplemux は空のワークスペースにフォールバックして最初からやり直します。

次のステップ