Commands Reference

Name: Lacy Shell
Availability: OnlineOnly
Author: Lacy Morrow

Lacy intercepts certain commands before they reach your shell. These run inside the plugin.

mode

bash

mode                 # show current mode + color legend
mode auto            # smart auto-routing (default)
mode shell           # force all input to shell
mode agent           # force all input to agent

tool

bash

tool                        # show active tool + available tools
tool set lash               # set active tool (persists to config.yaml)
tool set claude
tool set opencode
tool set gemini
tool set codex
tool set hermes
tool set custom "cmd --flag" # set a custom AI command

ask

bash

ask "what does this do"    # direct query to agent

Forces agent routing regardless of current mode.

Session commands

Session commands are prefixed with / and intercepted before shell execution:

bash

/new        # start a fresh AI conversation
/reset      # same as /new
/clear      # same as /new
/resume     # resume the last saved session

Note

/new also clears all terminal context state. The next query sends full context.

Quit

bash

quit    # exit lacy shell
stop    # same
exit    # same

Keybindings

Key	Action	Shell
`Ctrl+Space`	Toggle mode: Auto → Shell → Agent → Auto	ZSH + Bash
`→` or `Tab`	Accept ghost text suggestion (ZSH only)	ZSH
`Ctrl+C` (×2)	Quit lacy	ZSH + Bash

Emergency bypass

Prefix any input with ! to force shell execution, regardless of mode:

bash

!rm -rf build/   # forces shell, never routes to agent