battery-tool 0.2.4

A command-line tool to monitor your battery health on macOS in a detrimental way

BatteryTool

BatteryTool cycles your battery on autopilot - discharge to 5%, charge to 95%, check health, repeat until you cross the 80% threshold. Leave it plugged in, go about your life, come back to a warranty-eligible battery. I wrote about the whole process here.

If you purchased an AppleCare Protection Plan for your Mac laptop and your battery retains less than 80 percent of its original capacity, Apple will replace the battery at no charge.

Only tested on Apple Silicon MacBooks running macOS 15, simply because I have no other way to test other Macs. VMs don't allow IOKit access to the real SMC hardware.

Before you start

1. Turn off "Optimized Battery Charging" in System Settings > Battery (Apple will fight you otherwise)
2. Install Caffeine or something similar so your Mac doesn't fall asleep mid-cycle
3. Plug in your MacBook

Installation

uv tool install battery-tool
sudo battery-tool

Or for one-off usage:

sudo uvx battery-tool

Options

Flag	What it does	Default
--target-health	Stop when health drops to this %	79
--max-charge	Charge up to this % before discharging	95
--min-charge	Discharge down to this % before charging	5
--interval	How often to check battery, in seconds	60
--log-file	Write logs to a file	None
--status	Print current battery stats and exit	False

Acknowledgements

• battery.sh by Actually Mentor -- the battery management logic started here
• smc-command by hholtmann -- for talking to the SMC
• bclm -- for figuring out which SMC keys control charging