WinMole

A fast, keyboard-driven Windows system optimizer for the terminal. Clean junk, manage startup, run maintenance, switch power profiles, and more from one TUI.

Quick Start

Run WinMole with one command (download + run):

npx github:YOUR_GITHUB_USERNAME/winmole

Or run directly from source:

go run .

Run this command inside the project folder. Requires Go 1.21+.

What The User Should Do

1. Open PowerShell as Administrator (recommended for full functionality).
2. Go to the WinMole project folder.
3. Run go run ..
4. Use arrow keys and Enter to navigate modules.

Features

| Module | Description | |---|---| | System Cleaner | Temp files, browser caches, prefetch, error reports, update cache | | Startup Manager | Enable or disable Windows startup entries | | Full Maintenance | Runs flush DNS, temp cleanup, recycle bin cleanup, RAM trim, and winget update flow | | Driver Manager | Lists installed drivers and allows update workflow via winget | | System Repair | Launches elevated DISM + SFC repair commands | | Power Profiles | Switch between Gaming, Work, and Battery modes |

One-Command Terminal Launch

Download and launch directly from GitHub:

npx github:YOUR_GITHUB_USERNAME/winmole

If you are already in the repository folder:

go run .

If you want to build and run as EXE:

go build -o winmole.exe .
./winmole.exe

If published to npm (wrapper command):

npx winmole

Manual Installation

git clone https://github.com/YOUR_USERNAME/winmole.git
cd winmole
go build -o winmole.exe .
./winmole.exe

Usage

Run as Administrator for full functionality (repair commands, startup edits, advanced cleanup).

up / down      Navigate list
enter          Open / confirm / run action
space          Toggle checkbox or change sort order
backspace      Go back to main menu

Requirements

• Windows 10 or Windows 11
• Go 1.21+ (to build from source)
• Node.js 14+ (only needed for npm/npx wrapper launch)

License

MIT — see LICENSE