Por qué slay?

Todo lo que necesitas para recuperar tus puertos.

TUI Interactivo

Busca, explora y selecciona múltiples procesos con navegación por teclado.

slay -i

Animaciones de Kill

Mira una bala volar por tu terminal cuando un proceso es eliminado.

slay 3000

Apagado Elegante

Primero SIGTERM, escala a SIGKILL solo si el proceso se niega a morir.

slay -g 3000

Modo Vigilancia

Sigue sondeando y mata automáticamente procesos que reaparecen en tu puerto.

slay -w 3000

Árboles de Procesos

Mata todo el árbol de procesos, hijos primero, para un cierre limpio.

slay --tree 3000

Salida JSON

Envía NDJSON a jq para scripting, pipelines de CI y automatización.

slay --json 3000

Etiquetas Inteligentes

Detecta automáticamente Node, Python, Docker, PostgreSQL, Vite y más de 20 más.

slay --all

Cero Dependencias

Sin excesos. Solo incluye lo necesario. Se instala en menos de un segundo.

npm i -g slay-port

Multiplataforma

Funciona en macOS (lsof), Linux (lsof) y Windows (netstat + taskkill).

works everywhere ✓

Perfiles predefinidos

Guarda combinaciones de puertos como perfiles.

slay --profile dev

Rangos de puertos

Mata un rango de puertos con slay 8000-8010.

slay 8000-8010

Info de puertos

Inspecciona puertos sin matar. Ve PID, CPU, memoria.

slay info 3000

Autocompletado Shell

Autocompleta comandos, flags y nombres de perfil en bash, zsh y fish.

slay completions zsh

Matar por Nombre

Apunta a procesos por nombre con soporte de regex. Excluye procesos específicos de operaciones masivas.

slay --name "node.*"

Hooks Post-Kill

Ejecuta comandos automáticamente después de matar — reinicia servidores, lanza builds o notifica a tu equipo.

slay 3000 --then "npm start"

Disponibilidad de Puerto

Verifica si los puertos están libres, encuentra el siguiente puerto disponible. Perfecto para CI y automatización.

slay check 3000

Deja de adivinar PIDs

La forma antigua es dolorosa. Con slay es un solo comando.

La forma antigua

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 forma slay

slay

$ slay 3000

3000 > node PID 12847 (Dev Server)

killed PID 12847 on port 3000 [SIGKILL]

Done in 0.2s

Cómo empezar

Listo y funcionando con un solo comando.

Inicio Rápido

npx slay-port 3000

Instalación Global

npm i -g slay-port && slay 3000

Inicio Rápido

pnpm dlx slay-port 3000

Instalación Global

pnpm add -g slay-port && slay 3000

Inicio Rápido

yarn dlx slay-port 3000

Instalación Global

yarn global add slay-port && slay 3000

Inicio Rápido

bunx slay-port 3000

Instalación Global

bun add -g slay-port && slay 3000

Inicio Rápido

brew install hammadxcm/slay/slay-port

Instalación Global

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

Inicio Rápido

sudo snap install slay-it --classic

Instalación Global

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

Inicio Rápido

sudo apt install slay-port

Instalación Global

sudo apt install slay-port && slay 3000

Inicio Rápido

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

Instalación Global

scoop install slay && slay 3000

Inicio Rápido

winget install hammadxcm.slay-port

Instalación Global

winget install hammadxcm.slay-port && slay 3000

Uso de API

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

Míralo en acción

Quince formas de eliminar.

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]

Programático API

Usa slay como librería en tus proyectos Node.js.

Exportaciones

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

}

Mata procesos por puerto. Con estilo.

Por qué slay?

TUI Interactivo

Animaciones de Kill

Apagado Elegante

Modo Vigilancia

Árboles de Procesos

Salida JSON

Etiquetas Inteligentes

Cero Dependencias

Multiplataforma

Perfiles predefinidos

Rangos de puertos

Info de puertos

Autocompletado Shell

Matar por Nombre

Hooks Post-Kill

Disponibilidad de Puerto

Deja de adivinar PIDs

La forma antigua

La forma slay

Cómo empezar

Míralo en acción

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

Programático API

Exportaciones

Mata procesos por puerto.
Con estilo.