lux-cli-exec(1)

📦 version 0.48.0, in nixpkgs unstable

💅 lux-cli-exec(1) — the manual page, bestie edition 🎀

okay so this is lux-cli-exec, straight out of the General Commands Manual, and it's genuinely one of those pages you're gonna want to screenshot and keep in the group chat. it runs a command you already installed with lux, and — plot twist — if that command isn't there, it'll install a package named after the command. iconic behaviour honestly. 🦋

✨ NAME ✨

lux-cli-exec — execute a command that has been installed with lux. and if the command is not found, a package named after the command will be installed. no cap, it just does that. 🫶

🌸 SYNOPSIS 🌸

lux-cli exec [--no-loader] [--server] [--extra-servers] [--namespace]
[--lua-dir] [--lua-version] [--tree] [--cache-dir] [--data-dir]
[--variables] [--profile] [--verbose] [--no-progress] [--no-prompt]
[--preset] [--nvim] [--no-tfa] [--timeout] [--max-jobs] [--no-luarc]
[--no-wrap-bin] [--user-agent] [-h|--help] <COMMAND>

💖 DESCRIPTION 💖

Execute a command that has been installed with lux. and like, if the command is not found? a package named after the command will be installed. that's the whole vibe. it's giving "I got you" energy. ✨

👑 OPTIONS 👑

so. many. flags. but like, in a good way. here's every single one, bestie, no skips:

  • --no-loader — Do not add require('lux').loader() to LUA_INIT. ⚠️ heads up: if a rock has conflicting transitive dependencies, disabling the Lux loader may result in the wrong modules being loaded. you've been warned, bestie 😭
  • --server <server> — Fetch rocks/rockspecs from this server. this one takes priority over the config file, so it's the main character here 💅
  • --extra-servers <extra-server> — Fetch rocks/rockspecs from these servers in addition to the main server{n}. this overrides any entries in the config file. more servers, more choices, slay.
  • --namespace <namespace> — Specify the luarocks server namespace to use. yup, that's it, that's the whole thing ✨
  • --lua-dir <prefix> — Specify the directory in which to install Lua if not found. like a lil "if you can't find it, put it here" note 🎀
  • --lua-version <ver> — Which Lua installation to use.{n} Valid versions are: '5.1', '5.2', '5.3', '5.4', '5.5', 'jit' and 'jit52'.{n} If not set, Lux will attempt to detect the Lua version:{n} - From the current project, if it has an exact Lua version requirement.{n} - From the Lua installation that is available on the PATH. smart girl behaviour, honestly 🌸
  • --tree <tree> — Which tree to operate on.{n} In a workspace, this can be used to specify a detached workspace tree. lowkey niche but highkey useful.
  • --cache-dir <cache-dir> — Specifies the cache directory, e.g. for luarocks manifests. keep it cute, keep it cached 💖
  • --data-dir <data-dir> — Specifies the data directory,{n} in which the default user install tree resides{n} (e.g. ~/.local/share/lux). home sweet home directory.
  • --variables <variable> — Override config variables.{n} Example: `lx -v "LUA=/path/to/lua" ...`. genuinely so useful, iykyk.
  • --profile <profile> — The build profile to use when compiling packages.{n} Default: release. the possible values are:
    • release
    • dev

pick your fighter 🫶

  • --verbose — Display verbose output of commands executed, enabling DEBUG logs.{n} To enable TRACE logs, set RUST_LOG=trace. it's giving "I want to see everything" energy 👑
  • --no-progress — Don't print any progress bars or spinners. for when the lil spinny things are too much, respectfully.
  • --no-prompt <NO_PROMPT> — Skip prompts, selecting the default option.{n} Prompting is enabled by default in terminal/TTY environments. possible values are:
    • true
    • false
  • --preset <preset> — Configure Lux for a specific environment.{n} Valid presets are: 'nvim'. the possible values:
    • nvim: Configure Lux for Neovim plugins 🌈
  • --nvim — [DEPRECATED] Configure lux for installing Neovim packages.{n} Use --preset nvim instead. it's giving "we moved on, and you should too" — still here for you though 🙈
  • --no-tfa — Disable prompts for two-factor authentication (2FA) codes.{n} It is strongly recommended to enable 2FA instead see (https://luarocks.org/settings/two-factor-auth). > bestie. please. enable the 2FA. this flag is not it 💀
  • --timeout <seconds> — Timeout on network operations, in seconds.{n} 0 means no timeout (wait forever). Default is 30. "wait forever" is such a mood but maybe don't.
  • --max-jobs <MAX_JOBS> — Maximum buffer size for parallel jobs, such as downloading rockspecs and installing rocks. 0 means no limit. Default is 0. go off, parallel queen 🔥
  • --no-luarc — Do not generate or update a .luarc.json file when building{n} a project. no luarc, no problem.
  • --no-wrap-bin — Do not wrap Lua bin scripts. simple. chic. done.
  • --user-agent <USER_AGENT> — The user agent to set when making web requests. Default is "lux/<version>". tell 'em who you are, periodt ⭐
  • -h, --help — Print help (see a summary with -h). because sometimes you just need the short version, and that's valid 💜
  • <COMMAND> — The command to run, followed by arguments to pass to it. the main event, the moment, the star of the show 🌟

and that's the whole page, bestie. you ate. no crumbs. 🍓

— sign-off city — this gorgeous lil page comes from exec in the lux-cli-exec(1) section of your General Commands Manual — source/version lux-cli-exec(1), dated lux-cli-exec(1), footer and all. mwah 💋✨

📦 where this page comes from