Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Aug 10:47
· 18 commits to main since this release
v0.1.0
ed73a1f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

The first public release of whowns — a standalone CLI that explains what installed and manages the commands on your PATH.

Ever wondered which node is actually running, why another version is hidden, or whether it came from Homebrew, nvm, Nix, or a vendor installer? whowns traces that ownership and shows the evidence behind its conclusion.

Highlights

Inspect command ownership

whowns node
whowns node --explain

whowns reports:

  • the executable currently selected by PATH
  • shadowed executables found later in PATH
  • the package manager, version manager, or installer that owns each executable
  • multi-level ownership such as node -> nvm -> Homebrew
  • paths, symlinks, package receipts, and manager queries used as evidence
  • confidence as confirmed, probable, or unknown

Get safe action guidance

For recognized owners, whowns suggests the appropriate commands for inspection, updates, and removal.

It never executes update or removal commands automatically. If ownership cannot be confirmed, it explains what remains unknown instead of assuming the executable was installed manually.

List common runtimes

whowns --all
whowns --all --explain

The list view is generated from the same ownership model used for individual command inspection.

Machine-readable output

whowns node --json
whowns --all --json

JSON output includes resolutions, ownership chains, evidence, confidence, and action guidance.

Recognized owners

This release recognizes:

  • Homebrew, Nix, and MacPorts
  • nvm, fnm, Volta, mise, and asdf
  • pyenv, rbenv, SDKMAN!, uv, and rustup
  • cargo install, pnpm home, Deno, and Bun installers
  • macOS Installer receipts and python.org framework installations
  • Linux packages owned by dpkg, RPM, pacman, or apk
  • operating-system paths

Installation

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/shm11C3/whowns/releases/latest/download/install.sh | sh

The installer:

  • detects macOS/Linux and the host CPU architecture
  • downloads the matching standalone binary
  • verifies the archive against SHA256SUMS
  • installs whowns to $HOME/.local/bin
  • installs the wio shorthand alias by default

To omit the alias:

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/shm11C3/whowns/releases/latest/download/install.sh \
  | sh -s -- --no-alias

Downloads

Prebuilt standalone binaries are available for:

  • macOS Apple Silicon
  • macOS Intel
  • Linux x86_64
  • Linux arm64

Release assets include SHA-256 checksums and GitHub artifact attestations.

Current limitations

  • Only executables discoverable through PATH are inspected.
  • Windows is not supported yet.
  • Shell configuration files are not traced back to the line that modified PATH.
  • macOS binaries are currently unsigned and not notarized.
  • whowns provides guidance but never performs updates or uninstallation.

Feedback

This is an early 0.1.0 release. Reports about unrecognized installation layouts, incorrect ownership conclusions, or additional package managers are welcome.

See the README or 日本語README for more details.

Assets 8
Loading