Repository navigation
0.3.0 - 2026-10-09
Release Notes
Changed
- Renamed from portwise to holdmap. The product maps agents, tools and apps — not only ports.
Binary, crates, config dir (~/.config/holdmap), project file (.holdmap.toml), env vars
(HOLDMAP_*), MCP server name, desktop bundle id (dev.holdmap.app) and site base path all
use the new name. Legacy$PORTWISE_HOME/$PORTWISE_*env vars, a leftoverportwise
config directory (migrated once), and.portwise.tomlproject files are still accepted.
Installers and release artifacts are now namedholdmap-*.
Added
- Control from the Agents surface. Reveal a folder, open it in your editor, or stop the
unprotected ports an agent started (desktop cards,holdmap agents --stop-ports, MCP
stop_agent_ports). Paths are verified against the current agents report before opening. - Developer tools in the catalog. Docker Desktop, OrbStack and Podman Desktop appear beside
AI coding agents, with the same folders / ports / access footprint. - TUI Agents tab. Cycle Ports → Graph → Agents with Tab; browse each agent's footprint.
- Site and docs reframe the problem around agents, tools and apps — not only ports. Marketing
pages, SEO copy, Interfaces, Features (agents screenshot), Footer and a new
Agents guide cover control, richer
skim and developer tools.
Changed
- Agents empty states, onboarding, shortcuts and MCP copy talk about tools and apps as well as
coding agents. Desktop hides port filters while the Agents tab is open and prefetches the badge
count. - Richer agent skim surfaces: memory, CPU, process count, stoppable count and parent on cards /
graph nodes / CLI / TUI / MCP text; child processes grouped as “tools & apps it started”; folder
source labels (working dir / child cwd / recent); TUIxstops an agent’s ports; demo includes
Docker Desktop. - Product copy (CLI
--help, desktop store metadata, README architecture, site CLI demo) aligns
with agents and tools; removed a duplicate desktopicon.svg.
Install holdmap 0.3.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/santoshshinde2012/holdmap/releases/download/v0.3.0/holdmap-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/santoshshinde2012/holdmap/releases/download/v0.3.0/holdmap-installer.ps1 | iex"Install prebuilt binaries into your npm project
npm install holdmap@0.3.0Download holdmap 0.3.0
| File | Platform | Checksum |
|---|---|---|
| holdmap-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| holdmap-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| holdmap-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| holdmap-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| holdmap-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
| holdmap-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/holdmapYou 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/holdmapInstall the desktop app
The installers have build-provenance attestations too (gh attestation verify <file> --repo santoshshinde2012/holdmap).