Witr
lastmod 2026-11-16created 2025-12-292 edits
witr(why-is-this-running)는 Pranshu Parmar 가 만든 명령줄 도구로, 실행 중인 프로세스·서비스·포트·컨테이너·파일이 왜 떠 있는지를 그것을 띄운 계보까지 거슬러 보여 준다. ps, lsof, ss, docker ps 출력을 사람이 직접 맞춰 보던 일을 PID 하나를 기준으로 묶어 한 번에 보고한다. Linux, macOS, Windows, FreeBSD 용 단일 정적 바이너리로 배포된다.
About
- 기본 보고서 외에
--short(계보만),--tree(자식 프로세스 포함),--json,--verbose(메모리·I/O·fd·스레드) 출력을 제공 - 종료 코드로 찾음(0), 경고 있음(1), 못 찾음(2), 권한 없음(3) 등을 구분함. 스크립트나 AI 코딩 에이전트가 쓰기 좋게 했고 Claude Code 용 공식 플러그인(skill)도 있음
- 인자 없이 실행하면 프로세스·포트·컨테이너·파일 잠금 네 탭의 TUI 가 열림. 유닉스에서는 TUI 에서 시그널 전송과 renice 도 가능
- 컨테이너는 Docker, Podman, nerdctl, K8s(crictl), Incus, LXC, LXD, FreeBSD jail 을 한꺼번에 찾음
- Linux 는
/proc, macOS 는ps·lsof·launchctl, Windows 는 Win32 API, FreeBSD 는procstat·sockstat을 씀. Homebrew, apt, winget, npm, conda 등으로 설치 - Apache-2.0 라이선스
목적과 개념
- 실행 중인 것에는 늘 원인이 있지만 supervisor·컨테이너·서비스·셸 등 여러 층에 흩어져 있어, 기존 도구로는 여러 출력을 직접 대조해야 함. witr 는 그 인과 관계를 드러내 보여 주는 데 목적을 둠
작동 원리
- 포트·서비스·컨테이너·파일을 모두 PID 로 바꾼 뒤, 그 PID 에 대해 무엇이 실행 중인지, 어떻게 시작됐는지, 무엇이 계속 돌게 하는지, 어떤 맥락에 속하는지를 답함
지원 대상
- 이름(위치 인자),
--pid,--port,--file,--container로 지정하고 여러 대상을 섞어 한 번에 조회함 - 이름은 기본이 부분 일치라
ssh가sshd도 찾음. 여러 개가 맞으면 후보를 보여 주고--pid로 다시 실행하게 하며,--exact로 정확히 맞출 수 있음
출력 구조
- Target, Process(PID·사용자·명령·시작 시각·재시작 횟수), Why It Exists(예: systemd → PM2 → node 계보), Source(systemd 유닛, launchd, Windows 서비스, 컨테이너 등)
- 작업 디렉터리, Git 저장소·브랜치, 소켓, 컨테이너 이미지와 Compose 파일 같은 맥락 정보
- Warnings 에는 root 로 실행, 공용 인터페이스에서 리스닝, 헬스체크 없는 컨테이너 같은 주의 사항이 붙음