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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/pranshuparmarwitr.svg)](https://yunodb.com/tools/pranshuparmarwitr?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/pranshuparmarwitr?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/pranshuparmarwitr.svg" alt="Featured on YunoDB" height="20"></a>