Mate processos por porta.
Com estilo.

Um CLI ultrarrápido que encontra e mata processos ocupando suas portas. TUI interativo, modo vigilância, árvores de processos e zero dependências.

Começar GitHub

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.

Animações de Kill

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

Encerramento Gracioso

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

Modo Vigilância

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

Árvores de Processos

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

Saída JSON

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

Labels Inteligentes

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

Zero Dependências

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

Multiplataforma

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

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
Uso da API
import { findByPort, killProcess } from 'slay-port'

Veja em ação

Doze 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

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