Skip to content

v2.4.0 Scan capacity + AI

Choose a tag to compare

@Prithvi-Web Prithvi-Web released this 24 Jul 19:50

🚀 Scan capacity, rebuilt

TreeMap's scan engine now stores results in a new packed format that uses about
6× less memory per item (~52 bytes per file/folder instead of ~330). Huge
scans that used to strain memory now run light, aggregate views (largest files,
file types, folders) are 7–10× faster, and the engine is built with headroom
for scans up to ~100 million items. What you see in the app is unchanged —
same numbers, same views, results verified byte-for-byte identical.

🤖 TreeMap now works with AI assistants

  • A built-in MCP server (npm run mcp) lets assistants like Claude Desktop
    scan folders, find the biggest files and duplicates, get cleanup suggestions
    and disk-full forecasts — under the same safety rules as the app: deletes go
    to the Trash only, and nothing outside a scanned folder can ever be touched.
  • The API documents itself: /api/openapi.json, /api/capabilities, plus a new
    AGENTS.md guide.
  • New safety rails: dry-run previews for deletes and offloads, an optional
    policy file (allowed folders, protected folders, per-operation size cap), an
    audit log of every destructive action, and retry protection so a repeated
    request can never delete twice.
  • Optional token protection + CORS for running TreeMap as a server, and new
    Dockerfile / docker-compose / systemd files. All of this is off by default —
    nothing changes unless you turn it on.

📦 Installing / updating

  • macOS: download the .dmg below. Auto-update can't self-install on macOS
    (the app isn't Apple-notarized), so the app will notify you and bring you here
    instead.
  • Windows: download the .exe — auto-update works normally.

Fully compatible with previous versions — your settings, snapshots and history
carry over untouched.