Skip to content

0.3.0 - 2026-10-09

Choose a tag to compare

@github-actions github-actions released this 09 Oct 17:21
eb54e65

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 leftover portwise
    config directory (migrated once), and .portwise.toml project files are still accepted.
    Installers and release artifacts are now named holdmap-*.

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); TUI x stops 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 desktop icon.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 | sh

Install 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.0

Download 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/holdmap

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/holdmap

Install the desktop app

File Checksums
holdmap-0.3.0-1.x86_64.rpm holdmap-desktop-linux-x64.sha256
holdmap_0.3.0_aarch64.dmg holdmap-desktop-macos-arm64.sha256
holdmap_0.3.0_amd64.AppImage holdmap-desktop-linux-x64.sha256
holdmap_0.3.0_amd64.deb holdmap-desktop-linux-x64.sha256
holdmap_0.3.0_x64-setup.exe holdmap-desktop-windows-x64.sha256
holdmap_0.3.0_x64.dmg holdmap-desktop-macos-x64.sha256
holdmap_0.3.0_x64_en-US.msi holdmap-desktop-windows-x64.sha256

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