Installation

The Porthole agent is a single static binary with no runtime dependencies. Pick the method for your platform — each one downloads the binary, verifies its SHA-256 checksum against the signed manifest, and puts porthole on your PATH.

macOS / Linux

curl -fsSL https://assets.porthole.professorhusnain.com/install.sh | sh

The script detects your OS and architecture, downloads the matching binary, verifies its checksum, and installs to /usr/local/bin/porthole (or $PORTHOLE_PREFIX/bin if you set that).

Prefer to read a script before piping it to a shell? Inspect it first:

curl -fsSL https://assets.porthole.professorhusnain.com/install.sh | less

Windows

irm https://assets.porthole.professorhusnain.com/install.ps1 | iex

Installs to %LOCALAPPDATA%\Porthole\bin and adds it to your user PATH. Open a new terminal afterwards so the PATH change takes effect.

Homebrew

brew install professorhusnain/tap/porthole

Verify

porthole version

prints the version and platform, for example:

porthole v0.1.0 (darwin/arm64)

Staying up to date

The agent can update itself in place:

porthole update          # download and install the latest version
porthole update --check  # report whether a newer version exists, without installing

update verifies the new binary's checksum before swapping it in, and refuses to clobber an install managed by a package manager (use that manager instead — e.g. brew upgrade).