lua features turns an agent’s built-in features on or off and sets the one structured setting a feature has. A change applies to the agent immediately, in sandbox and production alike.
Verified against lua-cli 3.33.0.
Synopsis
Description
Features are platform capabilities the model can use without any code of yours:rag (Knowledge Search over resources), webSearch, inquiry (conversational forms) and outboundChannels (sending on connected channels). lua features list prints the agent’s full catalog, which includes more names than these four; every name it prints can be passed to --feature-name.
Enabling an already enabled feature, or disabling a disabled one, is a no-op and says so. configure changes only a feature’s config and leaves its active state as it is; the one config today is the recipientScope of outboundChannels: current_user lets the agent message only the end user it is talking to, anyone lets it message recipients it chooses.
Without an action the command opens a menu where a feature’s prompt context can be edited in $EDITOR; that editing is interactive only. Every action in the Actions table runs without a prompt. Under --ci the menu exits 1 instead of waiting; pass an action and --feature-name.
Arguments
Actions
Options
A missing
--feature-name is ✖ usage: --feature-name is required for action "<action>" (exit 2) with the available names as the hint; an unknown one is ✖ not_found: Feature "<name>" not found (exit 3). configure without a valid scope prints ❌ --recipient-scope is required for configure (current_user | anyone) and exits 1.
Examples
List the catalog and the current state of each feature.Output
Output
Exit codes
See also
- Knowledge and features — what each feature does
- Add knowledge — resources and
ragtogether - Send proactive messages —
outboundChannelsin practice lua resources— the documentsragsearches