CLI Reference
After installation, the lacy command is available in your PATH (~/.lacy/bin). It's a pure bash binary with zero dependencies.
Commands
| Command | Description |
|---|---|
lacy setup | Interactive settings: AI tool, mode, config. Uses Node UI if available. |
lacy status | Show installation status, active tool, current mode, version. |
lacy doctor | Diagnose common issues: missing AI tool, shell config, PATH. |
lacy update | Pull latest changes from GitHub and reload. |
lacy config | Show current configuration. |
lacy config edit | Open config.yaml in $EDITOR. |
lacy install | Run the installer (delegates to npx or curl). |
lacy reinstall | Fresh installation from scratch. |
lacy uninstall | Remove Lacy Shell. Uses Node UI if available. |
lacy version | Show installed version. |
lacy help | Show all commands and usage. |
Hybrid Node delegation
setup, install, and uninstall try npx lacy@latestfirst for the rich @clack/prompts UI, then fall back to bash if Node is unavailable.
Force bash-only mode:
bash
LACY_NO_NODE=1 lacy setupTesting local changes
bin/lacy delegates to npx lacy@latest (the published npm package), not local code. To test local changes to the Node installer:
bash
# Run local Node installer directly
node packages/lacy/index.mjs
# Force bash fallback (skips npx entirely)
LACY_NO_NODE=1 bin/lacy setup