Installation

Lacy Shell installs to ~/.lacy and hooks into your shell by adding a singlesource line to your shell config file.

Prerequisites

ZSH or Bash 4+ — macOS default is Bash 3.2; upgrade with brew install bash
An AI CLI tool installed and working: lash, claude, opencode, gemini, codex, hermes, or a custom command. Lacy will prompt to install lash if none is detected.
Internet access for the curl/npx methods

curl (recommended)

One-line install. Downloads directly from lacy.sh and runs the bash installer:

bash

curl -fsSL https://lacy.sh/install | bash

The installer detects your shell (ZSH or Bash), adds the source line to the correct config file, and optionally runs interactive setup.

Homebrew

bash

brew install lacymorrow/tap/lacy

Updates via brew upgrade lacy.

npx

Runs the Node-based interactive installer with a rich CLI UI:

bash

npx lacy

Note

Node.js 18+ required. Falls back to the bash installer if Node is unavailable.

Manual (git clone)

bash

git clone https://github.com/lacymorrow/lacy.git ~/.lacy
# ZSH:
echo 'source ~/.lacy/lacy.plugin.zsh' >> ~/.zshrc
# Bash:
echo 'source ~/.lacy/lacy.plugin.bash' >> ~/.bashrc

Then reload your shell: source ~/.zshrc or open a new terminal.

Verifying the install

bash

lacy status

Shows the installed version, active AI tool, and current mode.

bash

lacy doctor

Diagnoses common issues — missing AI tool, misconfigured shell, etc.

Updating

bash

lacy update

Pulls the latest changes from GitHub and reloads the plugin.

Uninstalling

bash

lacy uninstall

Removes ~/.lacy and the source line from your shell config. Uses the Node UI if available, or the bash fallback.

Shell config files

Lacy adds one line to your shell config. The location depends on your shell:

Shell	Config file	Line added
ZSH	`~/.zshrc`	`source ~/.lacy/lacy.plugin.zsh`
Bash	`~/.bashrc` or `~/.bash_profile`	`source ~/.lacy/lacy.plugin.bash`