まだ「address already in use」と戦ってるの?「PortMux」で終わりに
- 公開
- 正式公開 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
pm2orsystemdare 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) |
| vibe | worktree 管理 | worktree の作成・切り替え・後片付けを簡単にする | CLI(Rust。記事時点は Deno) | 無料(OSS, MIT) |
| Phantom | worktree 管理 | 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 を消すと設定・ログ・プロセスの状態まですべて消えます。この削除は元に戻せません。