lua source lists the append-only history of source backups that lua push records for the agent, and restores one of them into your project. Nothing on this page changes what end users see; to change the live agent, promote an agent version.
Verified against lua-cli 3.33.0.
Synopsis
Description
Everylua push, including lua push backup, stores a backup of your project files as source version v<n>; files are deduplicated by content, so only changed files are uploaded. lua.skill.yaml records the source version your working copy matches under backup.activeVersion, and lua version create links each agent version to the source version current at that moment.
list prints the most recent 50 source versions unless --all lifts the server cap; --limit caps how many of the returned rows are shown. The active version is marked *. Each row shows the version, creation time, creator, what triggered it (batch push, rollback to v<n>), and a shortened content hash.
rollback --version <n> downloads version n’s files, overwrites the working copy, and then records the result as v<latest+1> triggered by rollback to v<n>; no earlier version is modified. It asks Rolling back to v<n> will overwrite local files and create a new version. Continue? unless --force is passed, and the global --ci flag does not suppress the prompt. A rollback changes only your files and the backup history, not the live agent: promote an agent version to roll production back, and use rollback when you need the files themselves. The command always prints a deprecation warning pointing at lua version promote for that reason. lua pull --version <n> performs the same restore keyed by agent version instead of source version.
Both subcommands need a project and a credential.
Arguments
Options
Examples
List recent source versions; the active one is marked*:
Output
Exit codes
See also
- Back up and restore source
lua pull— restore by agent versionlua version— promote to change what is livelua.skill.yaml— thebackupsection