lly config

View or modify your ~/.lly/config.toml.

lly config reads and writes the user configuration file at ~/.lly/config.toml. The file is plain TOML. You can edit it by hand in any editor, or use the four subcommands below for safe, atomic updates. Settings written here apply to every llyinvocation under the current user.

Subcommands

Four verbs cover the full surface: get, set, unset, and list. Keys are dotted paths into the TOML tree. Values are typed automatically (booleans, integers, durations, strings) and validated before they touch disk.

lly config get <key> prints the current value, or exits non-zero if unset.
lly config set <key> <value> writes the value, creating parent tables as needed.
lly config unset <key> removes the key and prunes empty parent tables.
lly config list dumps the resolved config (defaults merged with your overrides).

config

$ lly config set runtime.timeout_ms 30000 ✓ runtime.timeout_ms = 30000 $ lly config set auth.token_path ~/.config/lly/token ✓ auth.token_path = "/home/you/.config/lly/token" $ lly config set plugin.search_path ~/work/lly-plugins ✓ plugin.search_path = "/home/you/work/lly-plugins" $ lly config get plugin.search_path /home/you/work/lly-plugins $ lly config list # ~/.lly/config.toml (resolved) [auth] token_path = "/home/you/.config/lly/token" [runtime] timeout_ms = 30000 [plugin] search_path = "/home/you/work/lly-plugins" [telemetry] enabled = false [update] channel = "stable"

Important keys

Most users never touch this file. The handful of keys below are the ones worth knowing.

auth.token_path

Path to the access token cached after lly login. Defaults to ~/.lly/credentials. Override when you want the token to live under $XDG_CONFIG_HOME or on an encrypted volume. The file is created with mode 0600.

plugin.search_path

Where lly looks for plugin binaries. Defaults to ~/.lly/plugins. Accepts a single directory or a colon-separated list. Plugins installed via lly plugin installalways land in the first writable entry. See also lly plugin path.

runtime.timeout_ms

Wall-clock timeout for lly run. Defaults to 0 (no timeout). Set to a positive integer of milliseconds to bound runaway bricks during local testing.

telemetry.enabled

Anonymous usage counters. Defaults to false. When opted in, the CLI sends a compact event per command (subcommand name, exit code, duration, lly version) to rc.lilylabs.io. No source code, no identifiers, no brick contents. Off by default and stays off unless you flip it.

update.channel

Selects which release stream the self-updater follows. Valid values are stable (default) and beta. Beta exposes pre-release builds shipped through the RC resolver and is the channel the LILY team dogfoods.

Scoping and precedence

Configuration is resolved in this order, last write wins: built-in defaults, the user file at ~/.lly/config.toml, and finally environment variables prefixed LLY_ (for example LLY_UPDATE_CHANNEL=beta). Command-line flags override everything. lly doctor prints the resolved view if you suspect an override is in play.

Resetting

To revert a key to its default, use lly config unset <key>. To wipe the whole file, delete ~/.lly/config.toml. The next lly invocation regenerates an empty file on demand. Cached credentials and installed plugins are not affected by removing the config file.