About

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.

Features

• 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

Installation

Quick Install

curl -fsSL https://getjolt.sh/install.sh | bash

Homebrew

brew install jordond/tap/jolt

Cargo

cargo install jolt-tui

Nix

Run directly:

nix run github:jordond/jolt

Install to profile:

nix profile install github:jordond/jolt

Add to configuration.nix:

environment.systemPackages = [
  (builtins.getFlake "github:jordond/jolt").packages.${pkgs.system}.default
];

From Source

git clone https://github.com/jordond/jolt.git
cd jolt
cargo build --release
./target/release/jolt

See Building from Source for detailed instructions.

Usage

Start jolt's TUI:

jolt

A 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

Keyboard Shortcuts

Daemon

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 Support

See the Linux setup guide for configuring power metrics on Linux.

Building from Source

Prerequisites

You will need to install Rust, see the install docs

Build

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/jolt

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT — See LICENSE for details.

---

---

_{Built with the assistance of AI tools including Claude and GitHub Copilot.}