witr
Why is this running? Trace any process, port, container, or file back to what started it - CLI + TUI.
What is witr?
Why is this running? Trace any process, port, container, or file back to what started it - CLI + TUI.
Overview of witr
What it is
witr is a command-line tool and TUI that traces any process, port, container, or file back to the exact chain that started it. It answers the question “Why is this running?” by making causality explicit, showing how something started, what keeps it running, and what context it belongs to. It outputs human-readable reports, JSON for scripts and AI agents, or an interactive TUI dashboard.
Key features
- Traces any process, port, container, or file back to its origin chain - Outputs results as human-readable text, JSON, or an interactive TUI - Supports multiple targets: PID, port, container name, file path, or process name - Works across Linux, macOS, FreeBSD, and Windows - Available via many package managers (APT, Homebrew, Conda, Winget, NPM, etc.)
- Single static binary distribution
Use cases
- Investigating why a specific process is running on a system - Identifying what is holding a port open and why - Tracing containerized workloads back to their supervisor (Docker, Podman, Kubernetes)
- Scripting or feeding causality data into AI agents via JSON output - Browsing all running processes and their origins in the interactive TUI
Getting started
Quick install on Unix (Linux, macOS, FreeBSD): bash curl -fsSL https://raw.githubusercontent.com/pranshuparmar/witr/main/install.sh | bash Quick install on Windows (PowerShell): powershell irm https://raw.githubusercontent.com/pranshuparmar/witr/main/install.ps1 | iex For other installation methods (package managers, source, manual), see the repository README.
License and pricing
Licensed under Apache-2.0. Open source.
Based on the project's public README and repository metadata.