Installation

Stable Release

Install the latest version with a single command:

curl -fsSL https://luca.tools/install.sh | bash

The installer:

1. Detects your OS and architecture (macOS arm64/x86_64, Linux x86_64/arm64)
2. Downloads the appropriate Luca binary from GitHub Releases
3. Installs it to ~/.local/bin/luca (no sudo required); set INSTALL_DIR=/usr/local/bin before running the installer to opt into the old system-wide location
4. If ~/.local/bin isn't already on your PATH, appends an export PATH line to your shell RC file (~/.zshrc or ~/.bashrc)
5. Installs the shell hook to ~/.luca/shell_hook.sh and sources it from ~/.zshrc or ~/.bashrc
6. Optionally installs the git post-checkout hook if you're inside a git repository

Pinning the CLI Version

Create a .luca-version file before running the installer to pin a specific version:

echo "0.21.0" > .luca-version
curl -fsSL https://luca.tools/install.sh | bash

The installer reads .luca-version from the current directory. This is useful for teams that need a consistent CLI version across machines.

Building from Source

Requires Swift 5.7+ and macOS 13+ or Linux.

git clone https://github.com/LucaTools/Luca.git
cd Luca
swift build -c release
cp .build/release/luca ~/.local/bin/luca

On Linux, build a static binary that doesn't require the Swift runtime:

swift build -c release -Xswiftc -static-stdlib

Verifying the Installation

luca --version

Expected output: the installed version number (e.g. 0.21.0).

luca --help

Expected output: the list of available subcommands (install, run, init, uninstall, installed, linked, unlink, update, agents).

Uninstalling

curl -fsSL https://luca.tools/uninstall.sh | bash

This removes the luca binary from ~/.local/bin (or INSTALL_DIR if you customized it), the PATH export line it added, the shell hook from ~/.luca/, and the source line from your shell RC file.