explaingit

ali-expandings/mactune

Analysis updated 2026-05-18

16ShellAudience · generalComplexity · 1/5LicenseSetup · easy

TLDR

MacTune is a single bash script that diagnoses why a Mac is slow, applies only safe reversible fixes, and scores your Mac's health from 0 to 100.

Mindmap

mindmap
  root((MacTune))
    What it does
      Diagnoses slowness
      Safe reversible fixes
      0-100 health score
      History tracking
    Tech stack
      Bash
      macOS
    Use cases
      Speed diagnosis
      Cache cleanup
      Disk and battery health
      Thermal checks
    Audience
      Mac users
      Non-technical users
    Safety rules
      No sudo without asking
      Trash not delete
      No background daemon
      No security setting changes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Diagnose why a Mac feels slow using real measurements like memory pressure and disk health.

USE CASE 2

Get a 0-100 health score with each deduction traced to a specific finding.

USE CASE 3

Safely clean developer caches (npm, Xcode, pip) with recoverable Trash deletions instead of permanent removal.

USE CASE 4

Check for thermal throttling, failing disks, or battery degradation before assuming it's a software problem.

What is it built with?

BashmacOS

How does it compare?

ali-expandings/mactuneai-engineer-skool/zen-agentic-engineer-configblackhatdevx/claudefree-installer
Stars161616
LanguageShellShellShell
Setup difficultyeasyeasyeasy
Complexity1/52/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

One curl command or Homebrew tap, zero dependencies and no sudo required for the default run.

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

In plain English

MacTune is a single bash script that diagnoses what is actually making your Mac slow, applies only fixes that are safe to undo, and gives your machine a health score from 0 to 100. It runs on macOS 11 through macOS 26, works on both Apple Silicon and Intel chips, and requires no installation of additional software. Once it finishes, nothing is left running in the background. Most Mac cleaner apps lead with cache deletion and present the amount of space freed as evidence of improvement. MacTune takes a different approach and starts by measuring. It checks memory pressure (the correct indicator of RAM trouble, not how much free memory you have), looks at whether your Mac has been force-killing apps due to low memory, maps where disk space actually went (downloads, old backups, developer build folders, Trash), reads the drive's hardware health status, checks battery capacity on laptops, scans crash reports from the past week, detects whether Spotlight or Time Machine is currently running and making things feel slow, and checks for thermal throttling. It also has an optional network speed test for the cases where slowness turns out to be the internet rather than the machine. When it does make changes, the approach is cautious. Developer caches and similar items are moved to Trash rather than deleted outright, so you can recover them until you empty the Trash. Optional interface changes like reducing visual animations can be undone with a single flag. Admin-level operations require explicit permission and are skipped entirely if you prefer. There is also a dry-run mode that shows what the tool would do without changing anything. The health score deducts points for specific findings: critical memory pressure costs 30 points, a failing drive costs 40, kernel panics cost 15, and so on. Each deduction is tied to an actual measurement, so the score reflects real conditions rather than an arbitrary calculation. Each run saves a record to a history file so you can see whether things are improving over time. Installation is a one-line curl command or a Homebrew tap. Uninstalling removes one file plus an optional config folder. The project is MIT licensed and the full source is a single readable file.

Copy-paste prompts

Prompt 1
Show me the one-line curl command to install MacTune and how to uninstall it cleanly.
Prompt 2
Explain what MacTune's health score measures and why memory pressure matters more than free RAM.
Prompt 3
What is the difference between mactune --dry-run and a normal run?
Prompt 4
Walk me through what MacTune will and will not touch on my Mac, like SIP or FileVault.

Frequently asked questions

What is mactune?

MacTune is a single bash script that diagnoses why a Mac is slow, applies only safe reversible fixes, and scores your Mac's health from 0 to 100.

What language is mactune written in?

Mainly Shell. The stack also includes Bash, macOS.

What license does mactune use?

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is mactune to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mactune for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.