tldr-pages/tldr

Page request: powermetrics

Open

#21876 opened on Apr 4, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Shell (30,937 stars) (2,507 forks)batch import
help wantednew command

Description

Command description

powermetrics is a Mac-only pre-installed utility that provides many power-related measurements.

Command details

No response

Documentation

https://www.unix.com/man_page/osx/1/powermetrics/

Platform

macOS (OS X)

VCS repository link (e.g. GitHub, GitLab)

No response

Additional information

Didn't find official documentation from Apple. Maybe more info from this link? https://firefox-source-docs.mozilla.org/performance/powermetrics.html

Contributor guide

Tech stack
shell
Domain
documentationcli
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90
Research direction
Examine the provided man page at https://www.unix.com/man page/osx/1/powermetrics/ and the Mozilla documentation at https://firefox source docs.mozilla.org/performance/powermetrics.html to extract common flags and usage. Look at existing tldr pages for similar macOS commands like 'top' and 'vm stat' to follow the format. Create a new file at pages/osx/powermetrics.md with concise examples capturing the most useful functionality of powermetrics.