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), staged until it is deployed. 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, pushed-but-not-activated ones [STAGED], and dashboard drafts [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 stages the version it creates and offers to deploy it (default No); --auto-deploy deploys without asking, and --force alone skips the question and leaves it staged. Nothing the agent serves changes until one of these deploys runs, and lua version promote does not change the served persona either. production deploy is therefore both the activation step and the rollback: latest activates the newest push, and an earlier number switches back.
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