procinfo

Un inspector de procesos portátil para Linux y macOS. ¡Obtén detalles de cualquier proceso en ejecución al instante!

Consulta también procinfo_minimal.sh: implementación pura en sh de procinfo.

Instalación

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

O simplemente copia el script. Es un script bash sin dependencias más allá de las herramientas Unix estándar (ps, lsof, pgrep). O mejor aún, copia partes, combínalas, ¡crea un script que se adapte a tus necesidades específicas!

Características

• Multiplataforma - Funciona en Linux y macOS (¿no en Windows?)
• Cero dependencias - Excepto bash y herramientas Unix estándar, y quizás un sistema operativo.
• Árbol de procesos - Ver todos los padres de un proceso dado. (¡impactante!)
• Inspección de entorno - Ver variables de entorno para un proceso dado (-V o --env)
• Integración con systemd - Si un proceso pertenece a un .service, muestra la ruta a ese archivo .service.
• Integración SSH - Ver al instante el usuario@IP de la sesión ssh que inició el proceso.
• Integración git - ¿El proceso pertenece a un repositorio git? Ver la rama y la URL remota directamente en la salida.
• Conocimiento de Docker - Detecta contenedores, compose, id del contenedor, nombre de imagen, enlaces de puertos... Puede añadir más información después.
• Información de red - Muestra todos los puertos en escucha de un proceso.
• Lista de puertos - ¡Salida bonita de ss -tunlp para todos!
• Detección de bloqueos - Muestra archivos de bloqueo y archivos abiertos del proceso.
• Múltiples formatos - Legible para humanos, una línea corta o JSON
• Insensible a mayúsculas - procinfo nginx coincide con Nginx, NGINX, etc.
• Modo TUI con fzf - Resulta que fzf es bastante increíble. ¡Cuidado! Esto no reemplaza a top, está pensado para ver puertos abiertos, no todos los procesos.

Requisitos

procinfo:

• Un sistema tipo UNIX
• bash
• ps
• lsof
• pgrep

Dependencias opcionales:

• docker
• git
• systemctl
• whatis (incluido con man)
• jq (soporte de salida JSON)
• fzf (modo TUI)

procinfo_minimal:

• sh

Uso

# Modo TUI interactivo (requiere fzf)
procinfo --tui

# Por nombre de proceso
procinfo nginx

# Por puerto
procinfo --port 3306

# Por PID
procinfo --pid 1234

# Salida de una línea
procinfo --short nginx

# Salida JSON (requiere jq)
procinfo --json nginx

Ejemplo de salida

Target      : godot

Process     : godot.linuxbsd. (pid 234167)
User        : wenekar
Command     : ./bin/godot.linuxbsd.editor.x86_64 --verbose
Started at  : Wed Dec 31 19:12:10 2025
Running for : 1 minute, 6 seconds
RSS Memory  : 330 MB

Process tree:
  systemd (pid 1) → systemd (pid 1141) → konsole (pid 1725) → fish (pid 233851) → godot.linuxbsd. (pid 234167)

Source      : interactive fish shell
git info    : godot (fix-libdecor-ssd-fallback) - [email protected]:wenekar/godot.git
Working Dir : /mnt/Sandisk480/GitHub/godot
Open files  : /memfd:kwin-xkb-keymap-shared
              /memfd:wayland-cursor

Contenedor Docker

Target      : port 6379

Process     : docker-proxy (pid 31782)
User        : root
Command     : /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
Started at  : Wed Dec 31 01:45:01 2025
Running for : 17 hours, 28 minutes, 39 seconds
RSS Memory  : 6 MB

Process tree:
  systemd (pid 1) → dockerd (pid 25817) → docker-proxy (pid 31782)

Source      : container runtime
git info    : not found
Working Dir : /
Listening   : *:6379

Docker info :
  Container : redis (463ab2f88502)
  Image     : redis
  Compose   : backend_test (/home/wenekar/backend_test/docker-compose.yml)
  Internal  : 172.18.0.2:6379

Docker cheatsheet:
  docker logs redis
  docker exec -it redis sh
  docker top redis
  docker ps //see all containers

Opciones

¿Por qué?

Vi un anuncio en TikTok sobre un proyecto llamado witr, enlace al video de TikTok. Entonces pensé para mí mismo, ¿quién es el usuario objetivo? ¿Para quién es ese binario? ¿No es solo un envoltorio bash de ps -p? Así nació procinfo. Resulta que yo soy ese usuario objetivo. Consulta también el issue 32.

Licencia

MIT