Terminal
Terminal/Skill
Runs day-to-day Kestra environment tasks with the kestractl command-line tool: switching contexts, validating and deploying flows, and checking executions.
By Kestra
Works with
npx skills add kestra-io/agent-skills --skill kestra-opsUse this skill to perform day-to-day Kestra operations with kestractl.
Use this skill when the request includes:
nsfiles)Kestra 2.0 migration — delegate. For Kestra 1.3 → 2.0 migration or upgrade requests (readiness checks, kestra-migrate warnings, flows failing to parse on 2.0): search the installed agent skills for one named migrate-kestra-2 — by name, wherever the user's skills are installed (project or user scope). If available, use it: it drives the migration and calls kestra-ops for kestractl sub-operations. If not installed, prompt the user to install it, then delegate:
npx skills add kestra-io/agent-skills@migrate-kestra-2
dev, staging, prod)table for human-readable, json for automation)kestractl is installed and executable~/.kestractl/config.yaml or values are provided via env vars/flagsResolve config from highest to lowest precedence:
--host, --tenant, --token, --output)KESTRACTL_HOST, KESTRACTL_TENANT, KESTRACTL_TOKEN, KESTRACTL_OUTPUT)~/.kestractl/config.yaml)Common setup:
kestractl config add dev http://localhost:8080 main --token DEV_TOKEN
kestractl config add prod https://prod.kestra.io production --token PROD_TOKEN
kestractl config use dev
kestractl config show
--wait for run operations where needed).Flows:
kestractl flows list my.namespace
kestractl flows get my.namespace my-flow
kestractl flows validate ./flows/
kestractl flows deploy ./flows/ --namespace prod.namespace --override --fail-fast
Executions:
kestractl executions run my.namespace my-flow --wait
kestractl executions get 2TLGqHrXC9k8BczKJe5djX
Namespaces:
kestractl namespaces list
kestractl namespaces list --query my.namespace
Namespace files:
kestractl nsfiles list my.namespace --path workflows/ --recursive
kestractl nsfiles get my.namespace workflows/example.yaml --revision 3
kestractl nsfiles upload my.namespace ./assets resources --override --fail-fast
kestractl nsfiles delete my.namespace workflows --recursive
deploy, upload, delete).flows validate before flows deploy.--output json for scripting and automation reliability.--verbose in shared logs because it can expose credentials.nsfiles actions, confirm path scope and only use --force intentionally.kestra-ops to validate and deploy all flows in ./flows to prod.namespace with fail-fast enabled, then report what changed."kestra-ops to run my-flow in my.namespace, wait for completion, and summarize execution status."kestra-ops to upload ./assets to namespace files under resources with override enabled, then list uploaded files recursively."