immutablue-settings#
Query configuration values from the Immutablue settings system.
Synopsis#
immutablue-settings <jq-path>Description#
immutablue-settings retrieves configuration values from the hierarchical settings system. It uses jq-style paths to query YAML configuration files.
Settings are loaded in order of precedence:
~/.config/immutablue/settings.yaml(user settings, highest priority)/etc/immutablue/settings.yaml(system settings)/usr/immutablue/settings.yaml(default settings, lowest priority)
Arguments#
| Argument | Description |
|---|---|
<jq-path> | A jq-style path to the setting (e.g., .immutablue.profile.enable_starship) |
Examples#
Query a boolean setting#
$ immutablue-settings .immutablue.profile.enable_starship
trueQuery a string setting#
$ immutablue-settings .immutablue.header.has_internet_host_v4
9.9.9.9Query a nested setting#
$ immutablue-settings .services.syncthing.tailscale_mode
trueUse in a script#
#!/bin/bash
if [[ "$(immutablue-settings .immutablue.profile.enable_starship)" == "true" ]]; then
eval "$(starship init bash)"
fiCommon Settings#
| Path | Default | Description |
|---|---|---|
.immutablue.run_bootc_update | true | Update bootc during immutablue-update |
.immutablue.profile.enable_starship | true | Enable Starship prompt |
.immutablue.profile.ulimit_nofile | 524288 | File descriptor limit |
.immutablue.header.preferred_terminal | auto | Preferred terminal emulator |
See Settings Reference for the complete list of available settings.
Exit Codes#
| Code | Description |
|---|---|
| 0 | Success |
| 1 | Setting not found or invalid path |