procinfo

Um inspetor de processos portátil para Linux e macOS. Obtenha detalhes sobre qualquer processo em execução instantaneamente!

Veja também procinfo_minimal.sh - implementação pura em sh do procinfo.

Instalação

curl -fsSL https://raw.githubusercontent.com/wenekar/procinfo/main/procinfo.sh -o procinfo
chmod +x procinfo
sudo mv procinfo /usr/local/bin/

Ou apenas copie o script. É um script bash sem dependências além das ferramentas Unix padrão (ps, lsof, pgrep). Ou melhor ainda, copie partes dele, combine-as, crie um script que atenda às suas necessidades específicas!

Características

• Multiplataforma - Funciona no Linux e macOS (sem Windows?)
• Zero dependências - Exceto bash e ferramentas Unix padrão, e talvez um sistema operacional.
• Árvore de processos - Veja todos os pais de um determinado processo. (chocante!)
• Inspeção de ambiente - Veja variáveis de ambiente para um processo (-V ou --env)
• Integração com systemd - Se um processo pertence a um .service, mostra o caminho para esse arquivo .service.
• Integração SSH - Veja instantaneamente o user@IP da sessão ssh que iniciou o processo.
• Integração git - O processo pertence a um repositório git? Veja a branch e a URL remota diretamente na saída.
• Ciente de Docker - Detecta containers, compose, container-id, nome da imagem, bindings de porta... Pode adicionar mais informações depois.
• Informações de rede - Mostra todas as portas de escuta de um processo.
• Lista de portas - Saída bonita do ss -tunlp para todos!
• Detecção de locks - Mostra arquivos de lock e arquivos abertos do processo.
• Múltiplos formatos - Legível para humanos, uma linha curta ou JSON
• Case-insensitive - procinfo nginx corresponde a Nginx, NGINX, etc.
• Modo TUI com fzf - Acontece que fzf é meio incrível! Cuidado, isso não substitui o top, é destinado a ver portas abertas, não todos os processos.

Requisitos

procinfo:

• Um sistema do tipo UNIX
• bash
• ps
• lsof
• pgrep

Dependências opcionais:

• docker
• git
• systemctl
• whatis (incluído com man)
• jq (suporte a saída json)
• fzf (modo TUI)

procinfo_minimal:

• sh

Uso

# Modo TUI interativo (requer fzf)
procinfo --tui

# Por nome do processo
procinfo nginx

# Por porta
procinfo --port 3306

# Por PID
procinfo --pid 1234

# Saída em uma linha
procinfo --short nginx

# Saída JSON (requer jq)
procinfo --json nginx

Exemplo de Saída

Alvo      : godot

Processo     : godot.linuxbsd. (pid 234167)
Usuário        : wenekar
Comando     : ./bin/godot.linuxbsd.editor.x86_64 --verbose
Iniciado em  : Wed Dec 31 19:12:10 2025
Executando há : 1 minuto, 6 segundos
Memória RSS  : 330 MB

Árvore de processos:
  systemd (pid 1) → systemd (pid 1141) → konsole (pid 1725) → fish (pid 233851) → godot.linuxbsd. (pid 234167)

Origem      : shell fish interativo
info git    : godot (fix-libdecor-ssd-fallback) - [email protected]:wenekar/godot.git
Diretório de trabalho : /mnt/Sandisk480/GitHub/godot
Arquivos abertos  : /memfd:kwin-xkb-keymap-shared
              /memfd:wayland-cursor

Container Docker

Ao inspecionar uma porta vinculada a um container Docker:

Alvo      : porta 6379

Processo     : docker-proxy (pid 31782)
Usuário        : root
Comando     : /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 6379 -container-ip 172.18.0.2 -container-port 6379 -use-listen-fd
Iniciado em  : Wed Dec 31 01:45:01 2025
Executando há : 17 horas, 28 minutos, 39 segundos
Memória RSS  : 6 MB

Árvore de processos:
  systemd (pid 1) → dockerd (pid 25817) → docker-proxy (pid 31782)

Origem      : runtime de container
info git    : não encontrado
Diretório de trabalho : /
Escutando   : *:6379

Informações Docker :
  Container : redis (463ab2f88502)
  Imagem     : redis
  Compose   : backend_test (/home/wenekar/backend_test/docker-compose.yml)
  Interno  : 172.18.0.2:6379

Folha de dicas Docker:
  docker logs redis
  docker exec -it redis sh
  docker top redis
  docker ps //veja todos os containers

Opções

Por quê?

Vi um anúncio no TikTok sobre um projeto chamado witr, link para o referido vídeo do TikTok. Então pensei comigo mesmo: quem é o usuário alvo? Para quem é esse binário? Não é apenas um wrapper bash do ps -p? Assim nasceu o procinfo, e acontece que eu sou esse usuário alvo. Veja também issue 32.

Licença

MIT