CLI Reference#

Immutablue provides several command-line tools for system management.

Primary Commands#

CommandDescription
immutablueMain command (justfile wrapper) for common tasks
immutablue-updateUpdate all system components
immutablue-doctorSystem health checks and diagnostics
immutablue-settingsQuery configuration values

System Management#

CommandDescription
immutablue-libvirt-managerEnable/disable libvirt virtualization
immutablue-script-orchestratorRun scheduled scripts (internal)

VM & Testing#

CommandDescription
immutablue-lima-genGenerate Lima VM configurations
immutablue-qcow2-genGenerate qcow2 VM images

Quick Examples#

# Run system health check
immutablue doctor

# Update everything
immutablue update

# Check a setting value
immutablue-settings .immutablue.profile.enable_starship

# Enable virtualization
immutablue enable_libvirt