Pourquoi slay?

Tout ce qu'il faut pour récupérer vos ports.

TUI Interactif

Recherchez, parcourez et sélectionnez plusieurs processus avec la navigation au clavier.

slay -i

Animations de Kill

Regardez une balle traverser votre terminal quand un processus est éliminé.

slay 3000

Arrêt Gracieux

SIGTERM d'abord, escalade vers SIGKILL uniquement si le processus refuse de s'arrêter.

slay -g 3000

Mode Surveillance

Continuez à sonder et tuez automatiquement les processus qui réapparaissent sur votre port.

slay -w 3000

Arbres de Processus

Tuez l'arbre de processus entier, enfants d'abord, pour un arrêt propre.

slay --tree 3000

Sortie JSON

Envoyez du NDJSON vers jq pour le scripting, les pipelines CI et l'automatisation.

slay --json 3000

Labels Intelligents

Détecte automatiquement Node, Python, Docker, PostgreSQL, Vite et plus de 20 autres.

slay --all

Zéro Dépendance

Pas de superflu. N'embarque que le nécessaire. S'installe en moins d'une seconde.

npm i -g slay-port

Multiplateforme

Fonctionne sur macOS (lsof), Linux (lsof) et Windows (netstat + taskkill).

works everywhere ✓

Profils prédéfinis

Enregistrez des combinaisons de ports en profils nommés.

slay --profile dev

Plages de ports

Tuez une plage de ports avec slay 8000-8010.

slay 8000-8010

Info port

Inspectez les ports sans tuer. Voyez PID, CPU, mémoire.

slay info 3000

Autocomplétion Shell

Autocomplétez commandes, options et noms de profils dans bash, zsh et fish.

slay completions zsh

Tuer par Nom

Ciblez les processus par nom avec support regex. Excluez des processus spécifiques des opérations en masse.

slay --name "node.*"

Hooks Post-Kill

Exécutez automatiquement des commandes après le kill — redémarrez des serveurs, lancez des builds ou notifiez votre équipe.

slay 3000 --then "npm start"

Disponibilité des Ports

Vérifiez si les ports sont libres, trouvez le prochain port disponible. Parfait pour les scripts CI et l'automatisation.

slay check 3000

Arrêtez de deviner les PIDs

L'ancienne méthode est pénible. Avec slay, une seule commande suffit.

L'ancienne méthode

bash

$ lsof -iTCP:3000 -sTCP:LISTEN

node 12847 user 23u IPv4 TCP *:3000

$ kill -9 12847

$ lsof -iTCP:3000 -sTCP:LISTEN

# still alive... try again?

$ kill -SIGKILL 12847

La méthode slay

slay

$ slay 3000

3000 > node PID 12847 (Dev Server)

killed PID 12847 on port 3000 [SIGKILL]

Done in 0.2s

Pour commencer

Opérationnel en une seule commande.

Démarrage Rapide

npx slay-port 3000

Installation Globale

npm i -g slay-port && slay 3000

Démarrage Rapide

pnpm dlx slay-port 3000

Installation Globale

pnpm add -g slay-port && slay 3000

Démarrage Rapide

yarn dlx slay-port 3000

Installation Globale

yarn global add slay-port && slay 3000

Démarrage Rapide

bunx slay-port 3000

Installation Globale

bun add -g slay-port && slay 3000

Démarrage Rapide

brew install hammadxcm/slay/slay-port

Installation Globale

brew install hammadxcm/slay/slay-port && slay 3000

Démarrage Rapide

sudo snap install slay-it --classic

Installation Globale

sudo snap install slay-it --classic && slay 3000

Démarrage Rapide

sudo apt install slay-port

Installation Globale

sudo apt install slay-port && slay 3000

Démarrage Rapide

scoop bucket add slay https://github.com/hammadxcm/scoop-slay && scoop install slay

Installation Globale

scoop install slay && slay 3000

Démarrage Rapide

winget install hammadxcm.slay-port

Installation Globale

winget install hammadxcm.slay-port && slay 3000

Utilisation API

import { findByPort, killProcess } from 'slay-port'

Voyez-le en action

Quinze façons d'éliminer.

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

Kill by Name

slay --name "node.*"

$ slay --name "node.*" --exclude "vite"

PID 12847 node server.js (port 3000)

PID 13201 node worker.js (port 3001)

PID 14500 node vite.js (excluded)

killed 2 processes, 1 excluded

Post-Kill Hook

slay 3000 --then "npm start"

$ slay 3000 --then "npm start"

3000 > node PID 12847 (Dev Server)

killed PID 12847 on port 3000 [SIGKILL]

running hook: npm start

hook completed (exit 0)

Port Check

slay check 3000

$ slay check 3000

port 3000 is in use (node PID 12847)

$ slay check --next 3000

port 3002 is available

Init Config

slay init

$ slay init

✓ Created .slay.json with example profiles

Run Profile

slay --profile dev

$ slay --profile dev

3000 > node PID 12847 (Dev Server)

5173 > node PID 13201 (Vite)

5432 > pg PID 4510 (PostgreSQL)

killed 3 processes on 3 ports

Port Range

slay 8000-8005

$ slay 8000-8005

8000 > node PID 9001 (HTTP Alt)

8001 > node PID 9002 (HTTP Alt)

killed 2 processes on 2 ports (4 ports clear)

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]

Programmatique API

Utilisez slay comme bibliothèque dans vos projets Node.js.

Exports

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}` );

}

Tuez les processus par port. Avec élégance.

Pourquoi slay?

TUI Interactif

Animations de Kill

Arrêt Gracieux

Mode Surveillance

Arbres de Processus

Sortie JSON

Labels Intelligents

Zéro Dépendance

Multiplateforme

Profils prédéfinis

Plages de ports

Info port

Autocomplétion Shell

Tuer par Nom

Hooks Post-Kill

Disponibilité des Ports

Arrêtez de deviner les PIDs

L'ancienne méthode

La méthode slay

Pour commencer

Voyez-le en action

Basic Kill

Interactive Mode

Watch Mode

Force Kill

Graceful Shutdown

Multi-port

Dry Run

Process Tree

Kill by Name

Post-Kill Hook

Port Check

Init Config

Run Profile

Port Range

JSON Output

UDP Ports

All Listeners

Verbose Mode

Programmatique API

Exports

Tuez les processus par port.
Avec élégance.