Install

cargo install luxe-cli

Or build from source:

git clone https://github.com/evanwhittaker/luxe.git
cd luxe
cargo build --release
./target/release/luxe --version

Luxe needs a UTF-8 terminal and nothing else. It looks better with a Nerd Font — the tool cards, menu and statusline draw icons from one — but it doesn’t need one: glyphs picks a vocabulary that works with what you have, and every icon sits beside the words it labels, so nothing becomes unreadable either way. Out of the box Luxe checks whether those glyphs can actually be drawn and falls back on its own.

On Windows

Linux, macOS and Windows are all first-class: CI builds, lints and runs the whole suite on each. Windows Terminal is the terminal to use — conhost predates most of what a TUI needs.

One thing is worth installing: Git for Windows. Luxe finds its bash automatically even though the installer doesn’t put it on PATH, and the bash tool needs a POSIX shell to run the pipelines and quoting a model writes. Without one, commands go through cmd.exe — which runs cargo test or npm run build perfectly well and refuses most other things, saying so rather than leaving you to guess. (If WSL is installed, Luxe deliberately skips the bash.exe in System32: that one is the WSL launcher, and it would run your commands inside Linux against a different filesystem.)

Everything else is optional and detected: rg and fd make grep/glob faster, and a language server enables lsp_diagnostics. Luxe walks and searches the tree itself when they’re absent.

Your files live where Windows keeps them — %APPDATA%\luxe for configuration and credentials, %LOCALAPPDATA%\luxe for state and caches — unless you have set an XDG_* variable, which wins.