Quick Start

After installing, you're ready to go. Here's everything you need in 5 minutes.

Step 1 — Reload your shell

bash

source ~/.zshrc   # ZSH
# or open a new terminal

You'll see the lacy indicator appear to the left of your prompt. It changes color as you type — green for shell, magenta for agent.

Shell commands work exactly as before:

$ls -lashell

$cd ~/projects && git statusshell

Natural language routes to AI automatically:

$what files changed in the last commitagent

$fix the failing test in src/auth.tsagent

$explain what this doesagent

Press Ctrl+Space to cycle through modes: Auto → Shell → Agent → Auto.

Or use the mode command:

bash

mode         # show current mode
mode shell   # lock to shell-only
mode agent   # lock to agent-only
mode auto    # back to auto routing

bash

tool   # shows active tool and available tools

If no tool is detected, Lacy will prompt to install lash. To set a specific tool:

bash

tool set lash      # recommended
tool set claude    # Claude Code
tool set gemini    # Google Gemini

Manage AI conversation sessions:

bash

/new       # start a fresh session
/resume    # resume last session
/clear     # same as /new

If lacy ever routes something wrong, prefix with ! to force shell execution:

bash

!rm -rf build/   # forces shell execution regardless of mode

Tip

Run lacy setup for an interactive menu to configure your AI tool, default mode, and other settings.