How to Use the pmset -g therm Command in macOS Terminal to Diagnose Thermal Throttling and CPU Speed Reductions

When running intensive video renders, local AI models, or complex Xcode compilation tasks on a Mac, you may experience sudden drops in system responsiveness or sluggish cursor tracking. While Activity Monitor shows CPU percentage usage, it does not reveal whether the Apple Silicon or Intel processor is operating at full clock speeds or being intentionally throttled by the hardware thermal controller to prevent overheating.

macOS includes a native command-line power management tool: pmset. By inspecting the system’s thermal telemetry using the -g therm switch, you can instantaneously determine whether macOS is throttling your CPU, capping fan speeds, or reducing system charging rates due to thermal thresholds.

How Thermal Throttling Works in macOS

macOS employs a proactive closed-loop thermal protection daemon. When sensors inside the chassis detect temperatures approaching silicon safety ceilings, the operating system intervenes in stages:

• Fan Acceleration: Fans ramp to maximum RPM (on MacBook Pro, Mac Studio, and Mac mini models).
• CPU Speed Limiting: The kernel clamps CPU P-cores (Performance) and E-cores (Efficiency) to lower frequency tiers.
• Battery Charging Throttling: Reduces battery fast-charging wattage to decrease ambient heat inside the notebook enclosure.

Step-by-Step Diagnostic Inspection

1. Open macOS Terminal

Launch Terminal via Spotlight (Cmd + Space) or from /Applications/Utilities/.

2. Query Real-Time Thermal Limits

Execute the thermal status query:

pmset -g therm

Terminal prints the current hardware thermal telemetry status:

Note: No sysdir
CPU_Scheduler_Limit 	= 100
CPU_Available_CPUs  	= 10
CPU_Speed_Limit     	= 100

Interpreting pmset Thermal Metrics

Metric Name	Optimal Value	Throttled Example	Technical Meaning
CPU_Speed_Limit	100	50 to 75	The percentage of maximum CPU clock frequency currently permitted. A value of 60 means the CPU is running at only 60% of its base clock.
CPU_Scheduler_Limit	100	70	Maximum percentage of thread execution time slices allocated by the macOS Mach kernel scheduler.
CPU_Available_CPUs	Total Physical Cores	Reduced Core Count	The active core count. Under catastrophic thermal stress, macOS will offline cores entirely.

Monitoring Live Thermal Shifts During Sustained Workloads

To watch how thermal limits respond in real time while compiling software or rendering 3D scenes, combine pmset with a short shell loop:

while true; do clear; date; pmset -g therm; pmset -g thermsys; sleep 2; done

If CPU_Speed_Limit drops below 100 during heavy tasks, your Mac is thermally throttled.

Remediation Strategies for Thermal Throttling

• Elevate the Chassis: MacBook enclosures dissipate significant heat through the aluminium bottom plate. Use an elevated laptop stand to enhance underside convection airflow.
• Clean Exhaust Vents: Compressed air purges dust accumulation from radiator fins and centrifugal fan impellers on active-cooled Mac models.
• Inspect Background Runaways: Run top -o cpu to identify rogue background helper daemons consuming unexpected cycles.