lua jobs manages the jobs defined with LuaJob and pushed with lua push job. deploy, activate, and deactivate change what runs on the production schedule; trigger runs a job once, right now.
Verified against lua-cli 3.33.0.
Synopsis
Description
With no action the command opens a menu covering every action. Every action runs against production.view lists the jobs in lua.skill.yaml with the server’s status, schedule, last run, and next run. -i <name> narrows the list to one job; an unknown name exits 3. A job that lua.skill.yaml lists but the server no longer has shows Status: not found on the server, or exits 3 with a lua sync hint when named with -i.
versions prints a pointer to lua version list: per-primitive history is managed by agent versions.
deploy makes one pushed version live without a confirmation prompt. It is the same operation as lua deploy job --name <name> --set-version <ver> --force; lua deploy also records the deployed version in lua.skill.yaml and reports the agent version it promoted.
activate and deactivate turn the schedule on or off without changing the deployed version. A deactivated job does not run until you activate it again.
trigger runs the job once immediately and prints the execution ID. The schedule is unchanged. trigger and delete also resolve jobs that exist only on the server.
history prints the last 20 executions, newest first: status (COMPLETED, FAILED, RUNNING, or the server’s value), start and completion times, duration, the first 100 characters of the result, and the error if any. For full execution output use lua logs --type job --name <name>.
delete removes the job from the server. A job that has pushed versions is deactivated instead of deleted and stays in lua.skill.yaml until you remove it.
-i matches the job name or its ID. Every form needs a project directory and a credential.
Arguments
Accepted spellings:
show, info → view; list-versions → versions; publish → deploy; on, enable → activate; off, disable → deactivate; run, exec, fire → trigger; runs, log → history; rm, remove, del → delete.
Options
Examples
List the jobs with their schedule state.Output
Output
Exit codes
The full table is in Errors and exit codes.
See also
LuaJob— schedule types, timeout, and retry fieldsJobs— dynamic jobs created at runtime- Schedule a recurring job
lua deploy— the same deploy with the agent version reportedlua logs—--type job --name <name>