crater-cli-admin-job

name	crater-cli-admin-job
version	0.1.1
description	Use Crater CLI admin job commands to list, delete, lock, keep, and clean jobs.
metadata	{"requires":{"bins":["crater"]},"cliHelp":"crater admin job --help"}

Crater CLI Admin Job

Use this skill when the user asks for administrator job operations from the CLI. Administrator commands use the crater admin job ... prefix. Do not use --admin on ordinary crater job ... commands.

CRITICAL — Before doing anything else, MUST read crater-cli-shared (possible path: ../crater-cli-shared/SKILL.md) for global options, non-interactive use, errors, confirmation, and secret handling.

Command Map

• List admin-visible jobs: crater admin job ls
• Delete a job as admin: crater admin job delete <jobName>
• Lock cleanup: crater admin job lock <jobName> [--permanent | --days N | --hours N | --minutes N]
• Unlock cleanup: crater admin job unlock <jobName>
• Toggle low-usage keep state: crater admin job keep <jobName>
• Cleanup jobs: crater admin job clean waiting-jupyter|waiting-custom|long-running|low-gpu ...

Safe Defaults

Use crater admin job ls --json --no-interactive before destructive actions to confirm the exact backend jobName. User-facing display names are not always accepted by job APIs.

Do not pass negative durations or cleanup thresholds. lock requires --permanent or at least one positive duration field. Cleanup commands require --yes for non-interactive use. Long-running cleanup requires both positive day thresholds; low-GPU cleanup requires positive lookback and wait minutes, with utilization between 0 and 100.

Common Workflows

List a user's jobs as admin:

crater admin job ls --user alice --json --no-interactive

Delete a job as admin:

crater admin job delete jpt-alice-abcde --yes --json --no-interactive

Lock a job for cleanup protection:

crater admin job lock jpt-alice-abcde --days 1 --json --no-interactive

Clean low GPU usage jobs:

crater admin job clean low-gpu --time-range 90 --wait-time 30 --util 10 --yes --json --no-interactive