Skip to content

Gexos/Windows-First-Aid-Toolkit

Repository files navigation

Windows First Aid Toolkit

A practical first-step Windows repair utility built with AutoIt.

Built with AutoIt Platform Type Console UI Help Files Open Source GitHub Repo Blog

Overview

Windows First Aid Toolkit is a technician-friendly Windows troubleshooting tool designed to group common repair, cleanup, and service tasks into one clean interface.

Instead of opening Command Prompt and typing the same repair commands again and again, you can use a single GUI with checkbox-based repair options, menu-driven actions, and a console-style output pane.

The goal of the app is simple:

  • save time
  • reduce repetitive repair work
  • keep first-response troubleshooting organized
  • provide a cleaner workflow for technicians and power users

What the app does

Windows First Aid Toolkit focuses on safe and common first-step repair actions such as:

  • Flush DNS
  • Reset Winsock
  • Release and renew IP
  • Clear user temp folder
  • Clear system temp folder
  • Clear browser cache for common browsers
  • Run sfc /scannow
  • Run DISM /Online /Cleanup-Image /RestoreHealth
  • Restart Windows Update
  • Restart BITS
  • Restart Print Spooler
  • Create a restore point before changes

Features

Repair and cleanup options

  • Preparation section with restore point option
  • Network repair actions
  • Cleanup actions
  • Windows repair actions
  • Service restart actions

Console output styling

The lower output pane is designed like a technician console and supports different line styles, including:

  • command lines
  • normal output
  • warnings
  • success messages
  • section headers

Menus

Presets

  • Recommended
  • Network repair only
  • Cleanup only
  • System repairs only
  • Service restarts only

Actions

  • Run Selected
  • Check All
  • Clear All
  • Save Log Copy
  • Open Logs Folder
  • Clear Console Output
  • Exit

Help

  • Open Help TXT
  • Open Help HTML
  • About

Default behavior

When the app starts, only the Create restore point first checkbox is selected.

All other repair options are left unchecked by default.

This keeps the initial state safer and makes it easier to build a repair run intentionally.

Console output

The old activity log area has been replaced by a larger console-style output pane.

This pane shows:

  • commands before they run
  • command output
  • warnings
  • success lines
  • section markers

This gives the application a more practical technician feel while still keeping output readable.

Usage

Run from source

  1. Open the .au3 script in AutoIt SciTE
  2. Run it as Administrator
  3. Select the repair actions you want
  4. Use the Actions menu and choose Run Selected

Recommended workflow

A practical workflow is:

  1. Start with a restore point
  2. Run only the specific actions you actually need
  3. Watch the console output
  4. Save a log copy if needed
  5. Reboot only if one of the repairs requires it

Safety notes

This tool is meant for safe first-step troubleshooting, not deep recovery or destructive repair work.

Keep these things in mind:

  • Run the tool as Administrator
  • SFC and DISM can take a long time
  • Some actions may require a reboot
  • Browser cleanup works best when browsers are closed
  • Some files may be locked and skipped
  • Restore point creation depends on System Protection being enabled

Why this project exists

Windows technicians often repeat the same first-pass repair steps on different machines.

This project exists to turn that repetitive work into a cleaner process with:

  • fewer repeated commands
  • better visibility
  • faster execution
  • more consistent troubleshooting

Credits

  • Author: Giorgos Xanthopoulos
  • Icon credits: Hristos Kalaitzis

Links

Contributing

Suggestions, fixes, and improvements are welcome.

If you test the tool and find a bug, open an issue in the repository and include:

  • what you clicked
  • what happened
  • any AutoIt error message
  • and whether you were running the script or a compiled EXE

Windows First Aid Toolkit is built to make common Windows first-response repair work faster, cleaner, and more practical.

About

Windows First Aid Toolkit is a portable Windows troubleshooting utility for safe first-response repairs. It helps reduce repetitive command-line work by giving technicians a simple GUI for cleanup, network resets, service restarts, system checks, restore points, and logging.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors