Skip to content

0.2.0 - 2026-10-09

Choose a tag to compare

@github-actions github-actions released this 08 Oct 20:51

Release Notes

Added

  • AI coding agents, end to end. portwise now finds the coding agents running on your machine
    (Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf, Aider, Cline and others) and shows,
    for each one, the folders it works in, the ports it serves, the services and hosts it talks to,
    and its access: account, sandbox, approval flags, network listeners and macOS-protected
    folders. Each fact is marked seen, inferred or unknown. Chats, settings and tokens are never
    read.
    • Desktop: Agents view (⇧A): a card per agent next to a map of their shared footprint.
      Click a port to open its details.
    • CLI: portwise agents [AGENT] [-w] [--json].
    • MCP: list_agents, read-only.
  • Website at https://santoshshinde2012.github.io/portwise/ with a live, in-browser demo of the
    desktop app, including the Agents view with sample agents, install steps for every platform and
    a short guide. It is built from site/ and deployed by the Pages workflow.

Install portwise 0.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/santoshshinde2012/portwise/releases/download/v0.2.0/portwise-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/santoshshinde2012/portwise/releases/download/v0.2.0/portwise-installer.ps1 | iex"

Install prebuilt binaries into your npm project

npm install portwise@0.2.0

Download portwise 0.2.0

File Platform Checksum
portwise-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
portwise-x86_64-apple-darwin.tar.xz Intel macOS checksum
portwise-x86_64-pc-windows-msvc.zip x64 Windows checksum
portwise-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
portwise-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum
portwise-x86_64-unknown-linux-musl.tar.xz x64 MUSL Linux checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo santoshshinde2012/portwise

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation> --repo santoshshinde2012/portwise

Install the desktop app

File Checksums
portwise-0.2.0-1.x86_64.rpm portwise-desktop-linux-x64.sha256
portwise_0.2.0_aarch64.dmg portwise-desktop-macos-arm64.sha256
portwise_0.2.0_amd64.AppImage portwise-desktop-linux-x64.sha256
portwise_0.2.0_amd64.deb portwise-desktop-linux-x64.sha256
portwise_0.2.0_x64-setup.exe portwise-desktop-windows-x64.sha256
portwise_0.2.0_x64.dmg portwise-desktop-macos-x64.sha256
portwise_0.2.0_x64_en-US.msi portwise-desktop-windows-x64.sha256

The installers have build-provenance attestations too (gh attestation verify <file> --repo santoshshinde2012/portwise).