Installation

LuCLI is distributed as a runnable JAR and as a self‑contained binary. You need a recent Java runtime (Java 17+) to run LuCLI or to build the binary.

Quick Install (recommended)

Install the latest LuCLI using the bootstrap installers:

curl -LsSf https://lucli.dev/install.sh | sh

On Windows PowerShell:

powershell -ExecutionPolicy Bypass -NoProfile -Command "irm https://lucli.dev/install.ps1 | iex"

Install a specific version:

LUCLI_VERSION=0.2.1 curl -LsSf https://lucli.dev/install.sh | sh

powershell -ExecutionPolicy Bypass -NoProfile -Command "& { $env:LUCLI_VERSION='0.2.1'; irm https://lucli.dev/install.ps1 | iex }"

Requirements

  • Java 17 or later on your PATH (java -version)
  • (Optional) Maven 3.x if you want to build LuCLI yourself
  • macOS , Linux or Windows (via .bat file)

Installing from a JAR

If you have a pre‑built JAR:

java -jar lucli.jar --version

You can add a shell alias for convenience:

alias lucli='java -jar /path/to/lucli.jar'

Installing the Self-Contained Binary

The self-coontained binary runs the jar without needing to type java -jar each time. We provide pre-built binaries for macOS and Linux. As well as a windows .bat file.

  1. Download the latest binary from the releases page.
  2. Make it executable:
chmod +x lucli
  1. Move it to a directory on your PATH, e.g.:
mv lucli /usr/local/bin/
  1. Verify installation:
lucli --version

Building from source

From the LuCLI project root:

./build.sh

This produces:

  • target/lucli.jar – runnable "fat" JAR with all dependencies included
  • target/lucli - self-contained binary (Linux or macOS)
  • lucli-<version>.jar - distributable JAR (not deps)

Keeping LuCLI up to date

Because LuCLI is a CLI tool, the simplest update process is:

  1. Download or build a new JAR/binary.
  2. Replace your existing lucli.jar or lucli binary on disk.
  3. Re‑open your shell or update any aliases if the path changed.