Repolode
Submit
vudsen

vudsen/ai-disk-cleaner

An AI-powered disk cleanup assistant that uses an LLM to find junk files and manages symbolic links and file migrations on Windows.

View on GitHub
Stars
333
Forks
29
Open issues
5
Last commit
last month

What is it?

ai-disk-cleaner scans a chosen location, builds a file tree, and hands it to an LLM, which identifies files that can be safely removed and summarizes the findings for the user. Scanning is powered by gdu, and the LLM reads the file tree through a tool interface that lets it mark trash files for review.

Beyond cleanup, the app offers centralized management of symbolic links and one-click migration of files to other drives, which helps free space on a crowded system drive without manual relinking. The project is a Go backend with a web-based interface and is currently distributed as a Windows executable.

Settings for the LLM are configured inside the application. Running it as administrator is recommended, since some deletion or migration operations need elevated permissions.

Key features

  • 01Uses an LLM to analyze disk usage and identify removable junk files
  • 02Presents the LLM's findings as a summary alongside a table of trash files
  • 03Manages symbolic links from one place
  • 04Migrates files to other drives with one click
  • 05Scans directories with gdu and loads the file tree into memory

Use cases

  • Freeing space on a nearly full Windows system drive
  • Finding large or forgotten junk files without manually browsing folders
  • Moving large folders to another drive while keeping existing paths working through symbolic links

Quick start

  1. 1

    Download the latest .exe from the Releases page

  2. 2

    Place the .exe in a dedicated folder; it creates its data files there

  3. 3

    Launch the application, preferably as administrator

  4. 4

    Open Settings, configure LLM parameters, then go home and start scanning

Things to know

  • Currently Windows only.
  • Requires configuring an LLM, so you need access to a model endpoint.
  • Some deletion or migration operations may fail without administrator rights.

Topics

#disk-cleanup#llm#windows#symbolic-links#file-management#go#disk-cleaner

FAQ

What is ai-disk-cleaner?
An AI-powered disk cleanup assistant that uses an LLM to find junk files and manages symbolic links and file migrations on Windows. ai-disk-cleaner scans a chosen location, builds a file tree, and hands it to an LLM, which identifies files that can be safely removed and summarizes the findings for the user. Scanning is powered by gdu, and the LLM reads the file tree through a tool interface that lets it mark trash files for review.
Is ai-disk-cleaner free to use? What license does it have?
ai-disk-cleaner is open source under the MIT license. Check the license terms before using it in commercial products.
Is ai-disk-cleaner still maintained?
Updated within 6 months. The last commit to ai-disk-cleaner was on Sep 10, 2026.
What can I use ai-disk-cleaner for?
Freeing space on a nearly full Windows system drive Finding large or forgotten junk files without manually browsing folders Moving large folders to another drive while keeping existing paths working through symbolic links
How do I install ai-disk-cleaner?
Download the latest .exe from the Releases page Place the .exe in a dedicated folder; it creates its data files there Launch the application, preferably as administrator Open Settings, configure LLM parameters, then go home and start scanning
Where can I get ai-disk-cleaner?
The source code and installation instructions are on GitHub: https://github.com/vudsen/ai-disk-cleaner

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects