CLI Reference

Complete reference for all jolt commands and options.

Global Options

Option	Short	Description
--help	-h	Show help information
--version	-V	Show version

Commands

jolt / jolt ui

Launch the interactive TUI.

jolt

The TUI is the default command and can be configured via the config file. See Configuration for details on themes, refresh rates, and other settings.

jolt pipe

Output metrics as JSON for scripting.

jolt pipe [OPTIONS]

Option	Short	Default	Description
--samples	-s	0	Number of samples (0 = infinite)
--interval	-i	1000	Interval between samples (ms)
--compact	-c	false	One-line JSON output (JSONL)

Examples:

# Single sample
jolt pipe --samples 1

# Continuous at 500ms
jolt pipe --interval 500

# Compact JSONL format
jolt pipe --compact

jolt debug

Print system and battery information for troubleshooting.

jolt debug

Shows:

• System model and chip
• macOS version
• Battery information source
• Power metrics availability
• Terminal capabilities

jolt config

Manage configuration.

jolt config [OPTIONS]

Option	Description
(none)	Show current config
--path	Show config file path
--reset	Reset to defaults
--edit	Open in $EDITOR

Examples:

# Show current config
jolt config

# Show config file path
jolt config --path

# Reset to defaults
jolt config --reset

# Open in editor
jolt config --edit

jolt theme

Manage themes.

jolt theme <SUBCOMMAND>

jolt theme list

List available themes.

jolt theme list [OPTIONS]

Option	Description
--iterm2	List importable iTerm2 themes
--search <QUERY>	Search themes by name
--variant <VARIANT>	Filter by variant: dark, light, all

jolt theme check

Validate themes for contrast issues.

jolt theme check [OPTIONS]

Option	Description
--theme <NAME>	Check specific theme
--fix	Attempt to auto-fix issues

jolt theme import

Import an iTerm2 theme.

jolt theme import <NAME>

jolt theme create

Create a new theme from template.

jolt theme create <NAME>

jolt theme open

Open themes folder in file manager.

jolt theme open

Opens the themes directory in Finder (macOS) or default file manager (Linux):

• macOS: ~/Library/Application Support/jolt/themes/
• Linux: ~/.config/jolt/themes/

jolt daemon

Manage background data collection.

jolt daemon <SUBCOMMAND>

jolt daemon start

Start the background daemon.

jolt daemon start [OPTIONS]

Option	Description
-f, --foreground	Run in foreground (don’t daemonize)

jolt daemon stop

Stop the running daemon.

jolt daemon stop

jolt daemon status

Show daemon status.

jolt daemon status

jolt daemon install

Install daemon to run on login (macOS only).

jolt daemon install [OPTIONS]

Option	Description
-f, --force	Overwrite existing LaunchAgent

jolt daemon uninstall

Remove daemon from login items.

jolt daemon uninstall

jolt logs

View application logs.

jolt logs [OPTIONS]

Option	Short	Default	Description
--lines <LINES>	-l	50	Number of lines to show
--follow	-f	false	Follow log output

Examples:

# Show last 50 lines
jolt logs

# Show last 100 lines
jolt logs --lines 100

# Follow logs in real-time
jolt logs --follow

jolt history

View and manage historical data.

jolt history <SUBCOMMAND>

jolt history summary

Show data summary.

jolt history summary [OPTIONS]

Option	Description
--period <PERIOD>	Time period: today, week, month, all

jolt history top

Show top power consumers.

jolt history top [OPTIONS]

Option	Default	Description
--limit	10	Number of results
--period	week	Time period
--sort	energy	Sort by: energy, cpu, time

jolt history export

Export data to JSON.

jolt history export [OPTIONS]

Option	Description
--output <FILE>	Output file (- for stdout)
--period <PERIOD>	Time period to export
--include-processes	Include process snapshots

jolt history prune

Remove old data.

jolt history prune [OPTIONS]

Option	Description
--older-than <DAYS>	Delete data older than N days
--dry-run	Show what would be deleted

jolt history clear

Delete all historical data.

jolt history clear [--force]

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments
3	Permission denied
4	Daemon not running
5	Config error

Environment Variables

Variable	Description
JOLT_CONFIG	Custom config file path
JOLT_THEME	Override theme
JOLT_APPEARANCE	Override appearance mode
JOLT_LOG_LEVEL	Logging level (error, warn, info, debug)
NO_COLOR	Disable colored output