Local Asset Optimizer is an open-source CLI agent for auditing storage, finding duplicate files, identifying old caches/build artifacts, and producing safe cleanup plans for local machines or vanilla Linux VPS instances.
It is built for people who want storage control without uploading private files to a cloud cleaner.
- Local-first: scans run on your machine or server.
- Zero telemetry: no tracking, remote logs, or analytics.
- Dry-run by default: reports are generated before any deletion.
- Approval-gated cleanup: destructive actions require explicit approval.
- Human-readable reports: storage findings are explained clearly.
- Conservative rules: system paths and sensitive directories are protected by default.
- Find large files taking up space.
- Detect duplicate files by content hash.
- Flag old cache folders such as
node_modules,.next,dist,build,.pytest_cache,__pycache__, and log archives. - Generate JSON and Markdown cleanup reports.
- Create a safe deletion manifest before cleanup.
python -m pip install .Scan a folder:
local-asset-optimizer scan ./my-folderWrite reports:
local-asset-optimizer scan ./my-folder --json ./reports/audit.json --markdown ./reports/audit.mdGenerate a cleanup manifest:
local-asset-optimizer plan ./my-folder --older-than-days 30 --manifest ./cleanup-manifest.jsonApply a manifest only after review:
local-asset-optimizer clean --manifest ./cleanup-manifest.json --approveThe CLI refuses to clean:
- filesystem root
- user home root
- core operating-system directories
- hidden security folders such as
.ssh,.gnupg,.aws,.config
Deletion is never based on vague AI output. The scanner produces deterministic file paths and the cleaner only acts on an explicit manifest.
- Python 3.10+
- Read access to the folders being scanned
- Write/delete permissions only if cleanup is approved
For VPS use, run first as a normal user against project directories. Avoid scanning the whole server until you understand the report.
Most storage cleaners are either too technical, too risky, or cloud-connected. Non-developers and small VPS owners need a tool that explains what is wasting space, shows exactly what would be deleted, and refuses dangerous actions by default.
Title: Local Asset Optimizer
One-line offer: A private, local cleanup agent that finds storage waste and creates approval-gated cleanup plans for your computer or VPS.
Ideal buyers:
- indie hackers
- non-technical founders
- agency operators
- VPS owners
- privacy-conscious users
- developers with many old project folders
Stop guessing what is eating your storage.
Local Asset Optimizer scans your folders, finds duplicate files, old build caches, bulky logs, and stale development artifacts, then gives you a readable cleanup report before anything is deleted.
It runs locally, collects zero telemetry, and requires explicit approval before cleanup. It is ideal for people managing personal files, project folders, or small VPS instances who want a safer alternative to blind cleanup scripts.
- Open-source core: free
- Gumroad support package: $19 to $39
- Pro checklist/report templates: $49
The value is saved time, reduced VPS disk pressure, and safer cleanup for non-technical users.
If scans are slow, start with a smaller folder.
If cleanup refuses to run, inspect the manifest and confirm the path is not protected.
If permission errors appear, run the scan from an account that can read the target files. Do not use elevated permissions until you understand the report.
- Run tests
- Verify package install
- Verify JSON report output
- Verify Markdown report output
- Verify cleanup manifest dry-run
- Verify protected path refusal
- Confirm zero telemetry statement
- Confirm no internal machine paths in docs
- Confirm buyer setup instructions are portable
MIT