procinfo

Linux と macOS 向けのポータブルなプロセスインスペクタ。実行中の任意のプロセスの詳細を即座に取得できます！

procinfo_minimal.sh も参照してください。procinfo の純粋な sh 実装です。

インストール

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

スクリプトをコピーするだけでも構いません。標準的な Unix ツール (ps, lsof, pgrep) 以外の依存関係は不要な bash スクリプトです。さらに良い方法として、その一部をコピーして組み合わせ、特定のニーズを満たす独自のスクリプトを作成することもできます！

機能

クロスプラットフォーム - Linux と macOS で動作します（Windows は非対応？）
依存関係ゼロ - bash と標準的な Unix ツール、そしておそらくオペレーティングシステム以外は不要。
プロセッツリー - 指定したプロセスのすべての親プロセスを表示します。（衝撃的！）
環境変数の検査 - 指定したプロセスの環境変数を表示します（-V または --env）
systemd 連携 - プロセスが .service に属している場合、その .service ファイルのパスを表示します。
SSH 連携 - プロセスを起動した ssh セッションの user@IP を即座に表示します。
git 連携 - プロセスが git リポジトリに属しているか？ブランチとリモート URL を出力に直接表示します。
Docker 対応 - コンテナ、compose、コンテナ ID、イメージ名、ポートバインディングを検出します… 後でさらに情報を追加する可能性あり。
ネットワーク情報 - プロセスのすべてのリッスンポートを表示します。
ポート一覧 - 見やすい ss -tunlp 出力を全員に！
ロック検出 - プロセスのロックファイルとオープンファイルを表示します。
複数の出力形式 - 人間可読、短いワンライナー、または JSON
大文字と小文字を区別しない - procinfo nginx は Nginx、NGINX などに一致します。
fzf による TUI モード - なんと、fzf はかなりすごい！注意：これは top の代替ではなく、全プロセスではなくオープンポートを確認するためのものです。

必要条件

procinfo:

UNIX 系システム
bash
ps
lsof
pgrep

オプションの依存関係:

docker
git
systemctl
whatis（man に含まれています）
jq（JSON 出力対応）
fzf（TUI モード）

procinfo_minimal:

使い方

# インタラクティブ TUI モード（fzf が必要）
procinfo --tui

# プロセス名で指定
procinfo nginx

# ポートで指定
procinfo --port 3306

# PID で指定
procinfo --pid 1234

# ワンライナー出力
procinfo --short nginx

# JSON 出力（jq が必要）
procinfo --json nginx

出力例

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

Docker コンテナ

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

オプション

なぜ作ったのか？

TikTok で witr というプロジェクトの広告を見ました。その TikTok 動画へのリンク。それで私は考えました。ターゲットユーザーは誰なのか？そのバイナリは誰のためのものなのか？これは単に ps -p の bash ラッパーではないのか？

こうして procinfo が誕生しました。結局のところ、私自身 がそのターゲットユーザーでした。issue 32 も参照してください。

ライセンス

MIT

`-p, --port <port>`	ポートでリッスンしているプロセスを検索
`-P, --pid <pid>`	特定の PID を調査
`-a, --all-ports`	すべてのリッスンポートを一覧表示
`-t, --tui`	インタラクティブ TUI モード（fzf が必要）
`-s, --short`	ワンライナー出力（プロセスチェーンのみ）
`-j, --json`	JSON 出力（jq が必要）
`-d, --description`	プロセスの説明を待機（macOS では遅い）
`--no-color`	色付き出力を無効化
`-h, --help`	ヘルプを表示
`-v, --version`	バージョンを表示

procinfo

人気

procinfo

インストール

機能

必要条件

使い方

出力例

Docker コンテナ

オプション

なぜ作ったのか？

ライセンス