A terminal-based battery and energy monitor for macOS and Linux.
jolt helps laptop users understand what's draining their battery. It provides real-time insights into power consumption, process energy usage, and battery health—all in a clean, themeable TUI.
- Battery Status — Charge percentage, time remaining, health, and cycle count
- Power Monitoring — System power draw with CPU/GPU breakdown
- Process Tracking — Processes sorted by energy impact with color-coded severity
- Historical Graphs — Track battery and power trends over time
- Themes — 10+ built-in themes with dark/light auto-detection
- Background Daemon — Collect historical data even when the TUI isn't running
- Process Management — Kill energy-hungry processes directly
curl -fsSL https://getjolt.sh/install.sh | bashbrew install jordond/tap/joltcargo install jolt-tuigit clone https://github.com/jordond/jolt.git
cd jolt
cargo build --release
./target/release/joltSee Building from Source for detailed instructions.
Start jolt's TUI:
joltA beautiful battery and energy monitor for your terminal
Usage: jolt [OPTIONS] [COMMAND]
Commands:
ui Launch the terminal UI (default)
pipe Output metrics as JSON for scripting
debug Print system and battery debug info
config Manage configuration
theme Manage themes
daemon Control the background daemon
history View and export historical data
logs View daemon logs
help Print this message or the help of the given subcommand(s)
Options:
--log-level <LOG_LEVEL> Set log level (error, warn, info, debug, trace)
-h, --help Print help
-V, --version Print version| Key | Action |
|---|---|
j / k |
Navigate up/down |
Enter |
Expand/collapse process group |
K |
Kill selected process |
g |
Toggle graph (battery/power) |
t |
Open theme picker |
s |
Open settings |
h |
View history |
? |
Show help |
q |
Quit |
jolt includes a background daemon for collecting historical data:
# Start the daemon
jolt daemon start
# Check status
jolt daemon status
# Stop the daemon
jolt daemon stop| Platform | Battery | Power Metrics | Notes |
|---|---|---|---|
| macOS (Apple Silicon) | ✅ | ✅ | Full support |
| macOS (Intel) | ✅ | ❌ | Battery data only |
| Linux | ✅ | ✅ | Requires RAPL permissions |
See the Linux setup guide for configuring power metrics on Linux.
You will need to install Rust, see the install docs
git clone https://github.com/jordond/jolt.git
cd jolt
# Debug build
cargo build
./target/debug/jolt
# Release build (optimized)
cargo build --release
./target/release/joltContributions are welcome! Please see CONTRIBUTING.md for guidelines.
MIT — See LICENSE for details.
Built with the assistance of AI tools including Claude and GitHub Copilot.