winget install --id=pratham15541.disktracker -e Fast cross-platform CLI for recursive disk usage analysis, storage tracking, and filesystem insights.
Created by Pratham Parikh
DiskTracker is a high-performance, real-time Windows file-system observation daemon and an AI-driven CLI interface.
Decoupled through a log-structured state machine model, it reads NTFS USN (Update Sequence Number) change logs to track volume modifications instantly without locking your drive or overloading system resources. Equipped with an LLM-driven LangGraph orchestration agent, you can query your disk status, find large files, track file mutation history, and manage space interactively using natural language.
Traditional disk space analyzers crawl the file system from scratch every time they run. This is slow, resource-heavy, and doesn't tell you when or how your space is growing.
DiskTracker resolves this by:
mutation_log) and processed by a background drain engine, preventing database locks and I/O bottlenecks.disktracker ask) utilizing LangGraph to execute reads, diagnostics, and pruning actions safely under human approval.DiskTracker uses a log-structured state machine model to separate fast write paths from relational analysis:
graph TB
subgraph Windows Kernel
USN["NTFS USN Journal"]
end
subgraph "Background Daemon (disktracker daemon)"
Watcher["USN Watcher Thread"] -->|Append-Only| MutLog[("SQLite mutation_log")]
Scanner["Baseline Scanner"] -->|Bulk Inserts Fact-Tree| Facts[("SQLite facts DB")]
Drain["Drain Engine"] -->|1. Polling Log| MutLog
Drain -->|2. Resolve file size/meta| USN
Drain -->|3. Merge UPSERT/DELETE| Facts
IPC["JSON-RPC Named Pipe Server"]
end
subgraph "CLI Tool (disktracker CLI)"
User["User Interface"] --> CLI["CLI Core Command Dispatch"]
CLI --> Client["Named Pipe Client Client"]
Client -->|Named Pipe: \\.\pipe\disktracker| IPC
subgraph "AI Subsystem (disktracker ask)"
Agent["LangGraph Agent Graph"] -->|Tool Execution| CLI
Agent -->|ChatModel Engine| LLM["OpenAI / OpenRouter API"]
end
end
facts table (transitions from BaselineScanning -> Reconciling -> Live).DiskTracker is built for Windows (x64 and ARM64). You can install it through several package managers or a standalone script.
Open Command Prompt or PowerShell as Administrator and run:
# Via PowerShell (Admin)
irm https://raw.githubusercontent.com/pratham15541/disktracker/main/install.ps1 | iex
npm install -g disktracker
choco install disktracker
winget install pratham15541.disktracker
Below is the quick reference card for DiskTracker commands.
| Command | Description |
|---|---|
disktracker init | Starts/Registers the background daemon as a Windows Service and crawls baseline facts. |
disktracker status | Queries the running daemon's status (PID, monitored volumes, and crawler phase). |
disktracker doctor | Runs diagnostic health checks (database integrity, journaling state, permissions). |
disktracker search | Performs a substring search on the database with optional file size/time filtering. |
disktracker history [path] | Displays file/directory mutation logs (Created, Modified, Deleted, Renamed). |
disktracker top | Lists the largest files, folders, or directories ranking by growth or modifications (churn). |
disktracker snapshot create | Takes a labeled snapshot of a volume's index state. |
disktracker snapshot diff <a> <b> | Diffs two snapshots to show net files created, updated, or removed between time frames. |
disktracker ai config | Configures your AI assistant API keys (OpenAI / OpenRouter base URL, API token). |
disktracker ask "" | Activates the LangGraph conversational agent to answer questions or prune folders. |
disktracker update | Checks GitHub for the latest release, downloads the zip archive, and performs a zero-downtime binary swap. |
disktracker uninstall | Stops the daemon service and deletes database logs. |
For detailed parameters and flags for each subcommand, read the CLI Command Reference Card.
disktracker ask)DiskTracker embeds an AI agent powered by LangGraph which operates as a ReAct (Reasoning and Acting) state machine. It is equipped with 12 tools to query and modify system state:
[User Input]
│
▼
┌───────────────────┐
│ Agent Node │◄───────────────────┐
└───────────────────┘ │
│ │
[Tools Condition Check] │
│ │
Is tool needed? │
/ \ │
(Yes) (No) │
/ \ │
▼ ▼ │
┌─────────────┐ ┌───────────────┐ │
│ Tools Node │ │ Final Answer │ │
└─────────────┘ └───────────────┘ │
│ │
[Runs Tool] ──────────────────────────────────┘
The agent is protected by Human-In-The-Loop (HITL) gates. If the AI tries to run a mutating command (such as deleting files or altering snapshots), the CLI pauses, displays the exact script to run, and asks for your explicit permission (y/n).
To read more about the agent tools, prompt structures, and configuration, see AI Agent Guide.
We plan to expand DiskTracker along these key vectors:
Testing Suite Expansion:
ci.yml) on every pull request.Adding observabilty dashboard + Opentelementary DiskTracker
+-------------------------+
| CLI |
+-----------+-------------+
|
v
+-------------------------+
| Daemon |
|-------------------------|
| USN Watcher |
| Baseline Scanner |
| Drain Engine |
| SQLite |
| Named Pipe RPC |
| LangGraph Agent |
+-----------+-------------+
|
OpenTelemetry SDK
|
OTLP Exporter
|
SigNoz/New Relic/Grafana/Others
Cross-Platform Support:
platform-macos utilizing Apple's FSEvents API.platform-linux utilizing the Linux inotify system.GUI Desktop Client: