まだ「address already in use」と戦ってるの?「PortMux」で終わりに

PortMux
Git worktree ごとに開発サーバーのポートを予約し、起動・停止と切り替えを受け持つ CLI
GitHub
公開
正式公開 2025-11-27(リポジトリ作成 2025-11-07)
作り手
Yuta Takahashi(個人)
対応
Mac
言語
英語
価格
無料(MIT ライセンス)
評価
GitHub のスター 13(2026-10-13)

どんなアプリか

PortMux は、開発中にバックグラウンドで動かすプロセスをまとめて起動・管理するためのコマンドラインツールです。サービスが複数あるプロジェクトで起きるポートの取り合いを解消するために作られていて、Git のブランチを並行して扱うときを主な場面にしています。

プロセスのグループを起動する前にポートを予約し、その予約を Git worktree に結びつけます。ほかの worktree がすでにそのポートを使っていれば、起動をすぐに止めてどの worktree が使っているかを表示します。select コマンドを使うと、前の worktree のプロセスを止めてから選んだ worktree で起動し直すので、同じポートを使い回せます。

設定はプロジェクトの portmux.config.json にグループ単位で書きます。グループごとに起動・停止・再起動ができ、設定や process.env の値を ${VAR} の形で環境変数に埋め込めます。プロジェクトのどのサブディレクトリからでもコマンドを実行できます。

While tools like pm2 or systemd are excellent for managing production services, PortMux is purpose-built for the development inner loop, prioritizing simplicity and eliminating common frustrations.

YTakahashii さん、GitHub の README

料金とデータの置き場所

MIT ライセンスで公開されている OSS です。常駐するプロセス(デーモン)は使わず、状態は手元の ~/.config/portmux/ の中にファイルとして保存します。

プロセスの標準出力と標準エラーは ~/.config/portmux/logs/ に書き出されます。ログファイルは、初期設定では 10MB を超えると新しい部分を残して切り詰められます。上限は logs.maxBytes で変えられ、ログの記録を止めることもできます。

同じ分野のアプリ

名前型仕掛け対応料金
PortMuxポート管理worktree ごとにポートを予約し、select で前の worktree を止めて切り替えるCLI(Node.js)無料(OSS, MIT)
tugポート管理compose.yaml を変えずに *.localhost へ自動で振り分け、ポート競合を解消CLI(Go)無料(OSS)
DevPulse開発環境モニタポート監視・Docker 管理・プロセスモニタ・ログを1画面にまとめるCLI(Rust、複数 OS)無料(OSS)
vibeworktree 管理worktree の作成・切り替え・後片付けを簡単にするCLI(Rust。記事時点は Deno)無料(OSS, MIT)
Phantomworktree 管理worktree をコマンド1つで作成・移動・削除し、AI エージェントを並行で走らせやすくするCLI無料(OSS, MIT)

入れる前に

Node.js 20 以上が必要で、npm または pnpm でグローバルにインストールします。インストールせずに npx で実行することもできます。

README では、正式に対応しているのは macOS です。Linux は動作が確かめられておらず、Windows は試験的な扱いです。

設定ファイルの command はシェルを通して実行されます。README では、信頼できる設定を使い、ほかの人と共有している portmux.config.json は実行する前に中身を確かめるよう呼びかけています。

アンインストールでは、npm か pnpm でパッケージを削除したあと、~/.config/portmux を消すと設定・ログ・プロセスの状態まですべて消えます。この削除は元に戻せません。