Repository navigation
0.2.0 - 2026-10-09
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.
- Desktop: Agents view (
- 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 fromsite/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 | shInstall 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.0Download 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/portwiseYou 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/portwiseInstall the desktop app
The installers have build-provenance attestations too (gh attestation verify <file> --repo santoshshinde2012/portwise).