DiskViz AI — Agent-first disk analyzer for Windows

Features

Everything you'd expect, plus what you'd build next.

Built with PyQt6 and D3.js. Native Windows 11 feel — no "AI decoration", no emoji, no rainbow gradients.

Interactive treemap

Click any block to drill in. Right-click to move files to another drive — no need to open Explorer.

Persistent cache

SQLite-backed. Re-scan the same folder and it's instant — typically 9.5× faster than a fresh scan.

Duplicate finder

3-stage hash: size → prefix → full. MD5, SHA1, SHA256. Delete findings straight to Recycle Bin.

Multi-drive charts

Pie chart usage across all drives. Top-20 largest folders. Pure SVG, no JS framework needed.

Export reports

HTML (sortable table), CSV (Excel-ready), Markdown (GitHub-friendly). Top 200 by default.

Move to another drive

Cross-drive copy + delete, or instant rename on the same drive. Real-time progress bar.

Keyboard-first

Ctrl+O browse, F5 scan, Ctrl+E export, Ctrl+D duplicates, Ctrl+H charts, Ctrl+, settings, Esc clear.

Drag & drop

Drop any folder onto the window to scan it instantly. No menu hunting.

Native settings

Persistent QSettings. Theme, max threads, max depth, hash algorithm, cache TTL — all editable.

How it works

Scan. Find. Move.

A three-step flow that takes you from "where did my disk go?" to "fixed" without leaving the app.

01 · Scan

See what's using space

Pick a drive or folder. Multi-thread walker fans out across subdirectories. Top files appear in the sidebar, treemap renders the rest.

          Press F5 to scan
        

→

02 · Find

Spot waste

Run the duplicate finder to surface content-identical files. Filter the sidebar by type or search by name. Inspect chart to see which folder is heaviest.

          Press Ctrl+D for duplicates
        

→

03 · Move

Free space, in app

Right-click any file or folder block → "Move to…". Pick a drive. Cross-drive copies with progress, then deletes the source. Auto-rescan after.

          Right-click → Move to…
        

MCP server · v4.0

Agent-first design.

DiskViz ships with a built-in MCP server over stdio. Any AI agent that supports MCP — Claude Desktop, Cursor, Cline, Windsurf — can call it as a tool.

scan Recursive scan with cache. Returns tree summary as JSON.
largest_files · largest_folders Top N by size. Perfect for "what's eating my drive?" questions.
find_duplicates Hash-based content dedup. Reports wasted bytes per group.
list_drives All fixed drives with total/used/free and percent full.
export_report Scan + write to HTML, CSV, or Markdown in one call.
cache_stats · clear_cache Inspect and manage the local SQLite cache.

# ~/.config/claude_desktop_config.json
{
  "mcpServers": {
    "diskviz": {
      "command": "python",
      "args": ["-m", "diskviz.mcp_server"],
      "cwd": "H:\\AI Project\\diskviz-ai",
      "env": {
        "PYTHONPATH": "H:\\AI Project\\diskviz-ai",
        "QT_QPA_PLATFORM": "offscreen"
      }
    }
  }
}
        

Then any agent can ask:

          "Tìm 10 file lớn nhất trong ổ M: của tôi"
        

and get a real, structured JSON answer — no screenshots, no copy-paste.

Disk space,
finally visible.