なぜ slay?
ポートを取り戻すために必要なすべて。
インタラクティブ TUI
キーボードナビゲーションでプロセスを検索、閲覧、複数選択。
キルアニメーション
プロセスが終了されるとき、ターミナルを弾丸が飛ぶのを見届けよう。
グレースフルシャットダウン
まず SIGTERM、プロセスが終了を拒否した場合のみ SIGKILL にエスカレート。
ウォッチモード
ポーリングを続け、ポートで復活するプロセスを自動キル。
プロセスツリー
プロセスツリー全体を終了。子プロセスから先に、クリーンなティアダウン。
JSON 出力
NDJSON を jq にパイプして、スクリプティング、CI パイプライン、自動化に活用。
スマートラベル
Node、Python、Docker、PostgreSQL、Vite など 20 以上を自動検出。
依存関係ゼロ
無駄なし。必要なものだけ。1秒以内にインストール完了。
クロスプラットフォーム
macOS (lsof)、Linux (lsof)、Windows (netstat + taskkill) で動作。
始め ましょう
1つのコマンドですぐに使える。
クイックスタート
npx slay-port 3000 グローバルインストール
npm i -g slay-port && slay 3000 クイックスタート
pnpm dlx slay-port 3000 グローバルインストール
pnpm add -g slay-port && slay 3000 クイックスタート
yarn dlx slay-port 3000 グローバルインストール
yarn global add slay-port && slay 3000 クイックスタート
bunx slay-port 3000 グローバルインストール
bun add -g slay-port && slay 3000 クイックスタート
brew install hammadxcm/slay/slay-port グローバルインストール
brew install hammadxcm/slay/slay-port && slay 3000 API の使い方
import { findByPort, killProcess } from 'slay-port' 実際の 動作を見る
12通りの終了方法。
Basic Kill
slay 3000
$ slay 3000
3000 > node PID 12847 (Dev Server)
* *
***
killed PID 12847 on port 3000 [SIGKILL]
Interactive Mode
slay -i
$ slay -i
> 3000 node PID 12847 Dev Server
8080 python PID 9321 HTTP Alt
5432 pg PID 4510 PostgreSQL
↑↓ navigate space select enter confirm
Watch Mode
slay 3000 -w
$ slay 3000 -w
watching port 3000...
killed PID 12847 [SIGKILL]
watching port 3000...
process respawned as PID 12901
killed PID 12901 [SIGKILL]
watching port 3000...
Force Kill
slay 3000 -f
$ slay 3000 -f
3000 > node PID 12847 (Dev Server)
*========================***
killed PID 12847 on port 3000 [SIGKILL]
no confirmation needed (-f)
Graceful Shutdown
slay 3000 --soft
$ slay 3000 --soft
3000 > node PID 12847 (Dev Server)
sending SIGTERM...
waiting for graceful exit (5s)...
process exited gracefully [SIGTERM]
Multi-port
slay 3000 8080 5432
$ slay 3000 8080 5432
3000 > node PID 12847 (Dev Server)
8080 > python PID 9321 (HTTP Alt)
5432 > pg PID 4510 (PostgreSQL)
killed 3 processes on 3 ports
Dry Run
slay 3000 -n
$ slay 3000 -n
3000 > node PID 12847 (Dev Server)
[dry run] would kill PID 12847
no processes were harmed
Process Tree
slay 3000 -t
$ slay 3000 -t
3000 > node PID 12847 (Dev Server)
└─ PID 12848 (worker)
└─ PID 12849 (worker)
killed tree: 12849, 12848, 12847
JSON Output
slay 3000 --json
$ slay 3000 --json
{"type":"found","pid":12847,"port":3000}
{"type":"killed","pid":12847,"signal":"SIGKILL"}
{"type":"summary","killed":1,"failed":0}
UDP Ports
slay 53 --udp
$ slay 53 --udp
53/udp > mDNSResponder PID 289
*========================***
killed PID 289 on port 53/udp [SIGKILL]
All Listeners
slay --all -y
$ slay --all -y
scanning all ports...
found 5 listening processes
killed 5/5 processes
0 failed
Verbose Mode
slay 3000 -v
$ slay 3000 -v
[tcp] 3000 > node PID 12847
[signal] sending SIGKILL to 12847
[timing] kill took 12ms
killed PID 12847 on port 3000 [SIGKILL]
プログラマティック API
Node.js プロジェクトで slay をライブラリとして使用。
エクスポート
-
findByPort(platform, port)Find processes on a specific port -
findByPorts(platform, ports)Find processes on multiple ports -
findAllListening(platform)Find all listening processes -
killProcess(platform, proc)Kill a single process -
killAll(platform, procs)Kill multiple processes -
enrichLabel(proc)Add smart labels to a process
api.ts
import { findByPort, killProcess, platform }
from 'slay-port';
const procs = await findByPort(platform, 3000);
for (const proc of procs) {
const result = await killProcess(platform, proc);
console.log( `Killed $${result.pid} on $${result.port}` );
}