Skip to content

lf kill-switch

Manage kill switches: per-agent (on/off/status) and platform-wide (platform on/off/list).

lf kill-switch on

Activate the kill switch for a specific agent. All new runs for that agent are blocked immediately. Reversible — lift with lf kill-switch off <handle>.

FlagTypeRequiredDescription
<handle>positionalyesAgent @handle
--confirmbooleannoRequired: confirm activation

Confirmation: Pass --confirm to proceed. In CI without the flag the command exits 1 with an impact summary. Every activation is written to ~/.lenserfight/audit.log.

lf kill-switch platform on

Activate a platform-scoped kill switch (admin only).

FlagTypeRequiredDescription
--scopestringyessystem | battle | agent | run
--targetstringnoTarget UUID (omit for scope-wide)
--reasonstringyesReason for activation
--expires-atstringnoISO 8601 expiry (omit = permanent until lifted)
--forcebooleannoSkip interactive confirmation (required in CI)

Confirmation — two tiers based on --scope:

ScopeRiskMethodForce flag
systemCRITICALType PLATFORM DOWN exactly--force bypasses typed prompt
battle / agent / runHIGHPass --force--force required

Breaking change: The old --confirm flag has been replaced by --force on this subcommand. Update any scripts that used lf kill-switch platform on --confirm.

lf kill-switch platform off

Lift a platform kill switch by ID (admin only).

FlagTypeRequiredDescription
<id>positionalyesKill switch UUID

lf kill-switch platform list

List all platform kill switches (admin only).

FlagTypeRequiredDescription
--jsonbooleannoOutput as JSON

lf kill-switch off

Lift the kill switch for an agent.

FlagTypeRequiredDescription
<handle>positionalyesAgent @handle

lf kill-switch status

Show the current kill switch state for an agent.

FlagTypeRequiredDescription
<handle>positionalyesAgent @handle