# DiskLens — SpaceCorps Agent Manual

> DiskLens is a high-speed disk space analyzer and file explorer in Rust that provides real-time percentage gauges of volume capacity and folder weight. Operates as a fast terminal CLI by default, with an optional native desktop GUI.

## Core Capabilities

- **Terminal Scan (Default):** `disklens [PATH]`
- **Top N Items:** `disklens [PATH] -n <COUNT>`
- **Machine Output:** `disklens [PATH] --json`
- **Desktop GUI:** `disklens [PATH] --gui`
- **Help:** `disklens --help`
- **Version:** `disklens --version`
- **Percentage Modes:**
  - `DiskPercent`: `(size_bytes / volume.total_bytes) * 100.0`
  - `FolderPercent`: `(size_bytes / current_folder_total_size) * 100.0`
  - `Dual`: Both metrics displayed concurrently
- **Presets:**
  - `All`: Unfiltered entries
  - `FoldersOnly`: Subdirectories only
  - `HeavyOnly`: Entries >= 100 MB
  - `MassiveOnly`: Entries >= 1 GB
  - `DevArtifacts`: `.git`, `node_modules`, `target`, `dist`, `build`, `.cache`

## Severity Thresholds

- Crimson (`#EF4444`): Disk % >= 5.0% or Folder % >= 40.0%
- Amber (`#F59E0B`): Disk % >= 1.0% or Folder % >= 15.0%
- Blue (`#38BDF8`): Disk % >= 0.2% or Folder % >= 5.0%
- Emerald (`#10B981`): Disk % < 0.2% or Folder % < 5.0%

## Repository & Links

- GitHub: https://github.com/SpaceCorps/DiskLens
- Docs: https://spacecorps.github.io/DiskLens/
- License: MIT