lua persona inspects the persona in your code and the persona versions on the server, and makes one version live. Deploying changes the persona for every end user immediately.
Verified against lua-cli 3.33.0.
Synopsis
Description
The persona is thepersona field of your LuaAgent. lua push agent uploads it and creates a numbered persona version (an integer, not a semver). lua persona works on those versions.
With no arguments the command asks for an environment and opens a menu.
lua persona sandbox view prints the persona from the compiled manifest in dist-v2/ and exits; run lua compile first. Any other sandbox form opens a menu whose entries are: view the full text; edit it in your editor, which rewrites the persona value in your source; create a version, which uploads the text as a new persona version; and list versions.
lua persona production view prints the deployed version number, date, creator, and text. production versions lists every version newest first, marking the deployed one ⭐ CURRENT and unpublished ones [DRAFT]. production deploy --persona-version <n> makes that version live; latest picks the newest. It asks for confirmation (default No) unless --force is given, and prints ✅ Persona version <n> deployed successfully to production. Deploying the version that is already live prints ℹ️ Version <n> is already deployed. and changes nothing, with exit 0.
lua deploy persona --set-version <n|latest> --force is the same operation from lua deploy. lua push agent also offers to deploy the version it just created (default No); --auto-deploy deploys without asking, and --force alone skips the question. Either way the pushed persona is already served from the agent’s next message, so that deploy changes nothing; production deploy matters when you switch back to an earlier version, which lua version promote does not do.
Every form needs a project directory and a credential.
Arguments
Accepted spellings:
staging, stage, stg, sb → sandbox; prod, prd, live → production; show, info → view; list-versions, history → versions; publish → deploy.
Options
Examples
Print the persona from your compiled code.Output
Output
Output
Exit codes
The full table is in Errors and exit codes.
See also
- About the persona — writing guidance and channel-specific personas
lua push—lua push agentcreates persona versionslua deploy—lua deploy personalua production— the deployed persona in the production summary- Release an agent