Por que slay?

Tudo o que você precisa para recuperar suas portas.

TUI Interativo

Pesquise, navegue e selecione múltiplos processos com navegação por teclado.

slay -i

Animações de Kill

Veja uma bala voar pelo seu terminal quando um processo é eliminado.

slay 3000

Encerramento Gracioso

SIGTERM primeiro, escala para SIGKILL apenas se o processo se recusar a parar.

slay -g 3000

Modo Vigilância

Continue monitorando e mate automaticamente processos que reaparecem na sua porta.

slay -w 3000

Árvores de Processos

Mate toda a árvore de processos, filhos primeiro, para um encerramento limpo.

slay --tree 3000

Saída JSON

Envie NDJSON para jq para scripting, pipelines de CI e automação.

slay --json 3000

Labels Inteligentes

Detecta automaticamente Node, Python, Docker, PostgreSQL, Vite e mais de 20 outros.

slay --all

Zero Dependências

Sem excessos. Envia apenas o necessário. Instala em menos de um segundo.

npm i -g slay-port

Multiplataforma

Funciona no macOS (lsof), Linux (lsof) e Windows (netstat + taskkill).

works everywhere ✓

Perfis predefinidos

Salve combinações de portas como perfis nomeados.

slay --profile dev

Faixas de portas

Mate uma faixa de portas com slay 8000-8010.

slay 8000-8010

Info de portas

Inspecione portas sem matar. Veja PID, CPU, memória.

slay info 3000

Autocompletar Shell

Autocomplete comandos, flags e nomes de perfil no bash, zsh e fish.

slay completions zsh

Matar por Nome

Alveje processos por nome com suporte a regex. Exclua processos específicos de operações em massa.

slay --name "node.*"

Hooks Pós-Kill

Execute comandos automaticamente após matar — reinicie servidores, acione builds ou notifique sua equipe.

slay 3000 --then "npm start"

Disponibilidade de Porta

Verifique se as portas estão livres, encontre a próxima porta disponível. Perfeito para scripts CI e automação.

slay check 3000

Pare de adivinhar PIDs

O jeito antigo é doloroso. Com slay é um único comando.

O jeito antigo

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

O jeito slay

slay

$ slay 3000

3000 > node PID 12847 (Dev Server)

killed PID 12847 on port 3000 [SIGKILL]

Done in 0.2s

Como começar

Pronto e funcionando com um único comando.

Início Rápido

npx slay-port 3000

Instalação Global

npm i -g slay-port && slay 3000

Início Rápido

pnpm dlx slay-port 3000

Instalação Global

pnpm add -g slay-port && slay 3000

Início Rápido

yarn dlx slay-port 3000

Instalação Global

yarn global add slay-port && slay 3000

Início Rápido

bunx slay-port 3000

Instalação Global

bun add -g slay-port && slay 3000

Início Rápido

brew install hammadxcm/slay/slay-port

Instalação Global

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

Início Rápido

sudo snap install slay-it --classic

Instalação Global

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

Início Rápido

sudo apt install slay-port

Instalação Global

sudo apt install slay-port && slay 3000

Início Rápido

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

Instalação Global

scoop install slay && slay 3000

Início Rápido

winget install hammadxcm.slay-port

Instalação Global

winget install hammadxcm.slay-port && slay 3000

Uso da API

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

Veja em ação

Quinze 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

Use slay como biblioteca nos seus projetos Node.js.

Exportações

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

}

Mate processos por porta. Com estilo.

Por que slay?

TUI Interativo

Animações de Kill

Encerramento Gracioso

Modo Vigilância

Árvores de Processos

Saída JSON

Labels Inteligentes

Zero Dependências

Multiplataforma

Perfis predefinidos

Faixas de portas

Info de portas

Autocompletar Shell

Matar por Nome

Hooks Pós-Kill

Disponibilidade de Porta

Pare de adivinhar PIDs

O jeito antigo

O jeito slay

Como começar

Veja em ação

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

Exportações

Mate processos por porta.
Com estilo.