インストール

クイックスタート で npx purplemux を実行してそれで十分なら、もう終わりです。このページは、永続的なインストール、デスクトップアプリ、ソースからの実行をしたい人向けです。

必要要件

• macOS 13+ または Linux — Windows はサポートしていません。WSL2 はだいたい動きますが、テスト対象外です。
• Node.js 20 以上 — node -v で確認。
• tmux — 3.0 以上のリリース。

インストール方法

npx (インストールなし)

npx purplemux

初回実行時に purplemux をダウンロードし、~/.npm/_npx/ の下にキャッシュします。試用やリモートマシンでのアドホック実行に最適です。実行のたびに最新版が使われます。

グローバルインストール

npm install -g purplemux
purplemux

pnpm や yarn でも同様に動作します (pnpm add -g purplemux / yarn global add purplemux)。2 回目以降は解決処理が不要なため起動が速くなります。アップデートは npm update -g purplemux で。

短縮形として pmux バイナリも使えます。

macOS ネイティブアプリ

最新の .dmg を リリース からダウンロードしてください — Apple Silicon と Intel のビルドを提供しています。自動アップデート対応です。

このアプリは Node、tmux、purplemux サーバを同梱し、さらに以下を追加します:

• サーバステータスを表示するメニューバーアイコン
• ネイティブ通知 (Web Push とは別)
• ログイン時の自動起動 (設定 → 一般 で切り替え)

ソースから実行

git clone https://github.com/subicura/purplemux.git
cd purplemux
pnpm install
pnpm start

開発用 (ホットリロード):

pnpm dev

ポートと環境変数

purplemux は 8022 で待ち受けます (web + ssh の語呂合わせ)。PORT で上書き可能です:

PORT=9000 purplemux

ロギングは LOG_LEVEL (デフォルト info) と、モジュール単位の上書き用 LOG_LEVELS で制御します:

LOG_LEVEL=debug purplemux
# Claude フックモジュールだけをデバッグ
LOG_LEVELS=hooks=debug purplemux
# 複数モジュールを同時に
LOG_LEVELS=hooks=debug,status=warn purplemux

利用可能なレベル: trace · debug · info · warn · error · fatal。LOG_LEVELS に列挙されていないモジュールは LOG_LEVEL にフォールバックします。

すべてのリストは ポート & 環境変数 を参照してください。

起動時に開始する

CLI インストールの場合、launchd (macOS) または systemd (Linux) でラップします。最小限の systemd ユニットの例:

# ~/.config/systemd/user/purplemux.service
[Unit]
Description=purplemux

[Service]
ExecStart=/usr/local/bin/purplemux
Restart=on-failure

[Install]
WantedBy=default.target

systemctl --user enable --now purplemux

アップデート

アンインストール

npm uninstall -g purplemux          # または pnpm remove -g / yarn global remove
rm -rf ~/.purplemux                 # 設定とセッションデータを消去

ネイティブアプリは通常通りゴミ箱にドラッグしてください。~/.purplemux/ に何が保存されているかは データディレクトリ を参照してください。