Repolode
Submit
jordond

jordond/jolt

A terminal-based battery and energy monitor for macOS and Linux that shows which processes drain your laptop battery.

Open-source alternative to:coconutBatteryiStat Menus

View on GitHubWebsite
Stars
572
Forks
14
Open issues
20
Last commit
5 days ago

What is it?

jolt is a terminal UI for understanding what is draining a laptop battery. It shows charge percentage, time remaining, battery health and cycle count, along with system power draw broken down into CPU and GPU.

Processes are listed by energy impact and colour-coded by severity, so heavy consumers are easy to spot. Users can expand process groups, kill a selected process from the interface, and view historical battery and power graphs.

A background daemon can record data while the TUI is closed, and a pipe command outputs metrics as JSON for scripts. Themes with dark and light auto-detection are included. Apple Silicon Macs get full power metrics, Intel Macs get battery data only, and Linux needs RAPL permissions for power readings.

Key features

  • 01Shows battery charge, time remaining, health and cycle count
  • 02Breaks system power draw into CPU and GPU
  • 03Ranks processes by energy impact with colour-coded severity
  • 04Records historical battery and power trends via a background daemon
  • 05Lets you kill energy-hungry processes from the interface
  • 06Provides JSON output for scripting and 10+ built-in themes

Use cases

  • Finding which app is quietly draining a MacBook or Linux laptop battery
  • Logging battery health and power usage over days or weeks
  • Feeding battery metrics into shell scripts or dashboards as JSON

Quick start

  1. 1

    Install with the quick install script

    Install with the official instructions in the README
  2. 2

    Or install via Homebrew

    brew install jordond/tap/jolt
  3. 3

    Start jolt's terminal UI

    jolt

Things to know

  • Supports only macOS and Linux, not Windows.
  • Power metrics on Intel Macs are unavailable, and Linux needs RAPL permissions configured.

Topics

#battery#terminal#tui#power-monitoring#macos#linux#rust#battery-monitor

FAQ

What is jolt?
A terminal-based battery and energy monitor for macOS and Linux that shows which processes drain your laptop battery. jolt is a terminal UI for understanding what is draining a laptop battery. It shows charge percentage, time remaining, battery health and cycle count, along with system power draw broken down into CPU and GPU.
Is jolt free to use? What license does it have?
jolt is open source under the MIT license. Check the license terms before using it in commercial products.
Is jolt still maintained?
Actively maintained. The last commit to jolt was on Oct 15, 2026.
What can I use jolt for?
Finding which app is quietly draining a MacBook or Linux laptop battery Logging battery health and power usage over days or weeks Feeding battery metrics into shell scripts or dashboards as JSON
How do I install jolt?
Install with the quick install script Or install via Homebrew: brew install jordond/tap/jolt Start jolt's terminal UI: jolt
Where can I get jolt?
The source code and installation instructions are on GitHub: https://github.com/jordond/jolt

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects