CLI Reference

Complete reference for all jolt commands and options.

Global Options

Option	Short	Description
--help	-h	Show help information
--version	-V	Show version
--log-level		Set log level (error, warn, info, debug, trace)

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
--builtin	Show builtin themes only
--user	Show user themes only
--iterm2	List importable iTerm2 themes
--search <QUERY>	Search themes by name

jolt theme check

Validate themes for contrast issues.

jolt theme check [OPTIONS]

Option	Description
-A, --all	Check all themes
-v, --verbose	Verbose output

jolt theme import

Import an iTerm2 theme.

jolt theme import <SCHEME> [OPTIONS]

Option	Description
-n, --name	Custom name for imported theme

jolt theme create

Create a new theme from template.

jolt theme create <NAME> [OPTIONS]

Option	Description
-t, --template	Template to use (default: blank)
-b, --base <THEME>	Base theme to inherit from

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 theme fetch

Fetch iTerm2 color schemes from the remote repository.

jolt theme fetch [OPTIONS]

Option	Description
-f, --force	Force refresh cache

This downloads the latest iTerm2 color schemes for use with jolt theme import.

jolt theme clean

Clean up cached theme data.

jolt theme clean [OPTIONS]

Option	Description
-y, --yes	Skip confirmation

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
XDG_CONFIG_HOME	Override config directory (default: platform-specific)
XDG_DATA_HOME	Override data directory
XDG_CACHE_HOME	Override cache directory
XDG_RUNTIME_DIR	Override runtime directory

See Configuration for XDG details.