badgr-cli 1.1.2 → 1.1.4

package/README.md

@@ -13,7 +13,7 @@ Badgr supports many GPU workloads through two commands: `serve` for persistent e
 npm install -g badgr-cli
 ```
 
-**Jump to:** [Quick start](#quick-start) · [Coding agents (`badgr launch`)](#coding--testing-agents-badgr-launch) · [Image generation](#also-try-image-generation) · [`badgr doctor`](#something-not-working-badgr-doctor) · [Commands](#commands) · [`serve` options](#badgr-serve-options) · [`run` options](#badgr-run-options) · [Receipts](#receipts) · [OpenAI compatibility](#openai-compatibility) · [GPU options](#gpu-options) · [Advanced](#advanced) · [Requirements](#requirements)
+**Jump to:** [Quick start](#quick-start) · [Coding agents (`badgr launch`)](#coding--testing-agents-badgr-launch) · [Image generation](#also-try-image-generation) · [`badgr doctor`](#something-not-working-badgr-doctor) · [`badgr diagnose`](#diagnose-a-gpu-issue-badgr-diagnose) · [Commands](#commands) · [`serve` options](#badgr-serve-options) · [`run` options](#badgr-run-options) · [Receipts](#receipts) · [OpenAI compatibility](#openai-compatibility) · [GPU options](#gpu-options) · [Advanced](#advanced) · [Requirements](#requirements)
 
 ---
 
@@ -103,13 +103,13 @@ Everything before `--` is a `badgr launch` flag; everything after `--` is passed
 | `--region US\|EU\|AU` | — | Region preference |
 | `--size small\|medium\|browser` | per-workload default | VM class override |
 
-### `badgr task` — a labeled launch
+### `badgr job` — a tracked coding-agent job
 
 ```bash
-badgr task "Run the Chromium tests and tell me what failed" --max-cost 1 -- npm run test:chromium
+badgr job cline "Run the Chromium tests and tell me what failed" --check "npm run test:chromium" --max-cost 1
 ```
 
-A thin wrapper over `badgr launch . -- <command>` — the description is printed for the human and otherwise discarded; the receipt and `badgr status` still key off the deployment ID like any other launch.
+Submits via `POST /v1/jobs` (`type: "agent"`) — the same Jobs API used by every other job type. Requires `--check <command>` (verifies success); tracked at `/jobs` with a `job_id`, status, logs, output, cost, and time.
 
 ---
 
@@ -159,21 +159,80 @@ Run `badgr doctor --help` for the full flag list. Details in
 
 ---
 
+## Badgr Smoke Test: `badgr diagnose`
+
+Paste a GitHub issue, a Docker image, a repo URL, a log file, a ComfyUI
+workflow, or a raw conversation — Badgr auto-detects the input, redacts
+secrets, and runs free static checks as part of a Badgr Smoke Test.
+Nothing runs on a GPU without explicit `--approve`.
+
+```bash
+# Free Badgr Smoke Test — no login required
+badgr diagnose "https://github.com/org/repo/issues/123"
+badgr diagnose ajayrajtp/vllm_gemma412b:latest
+badgr diagnose ./vllm-error.log
+badgr diagnose "https://github.com/org/repo"
+badgr diagnose workflow.json
+
+# Free mechanical validation of the produced command — still no GPU, no login
+badgr diagnose "https://github.com/org/repo/issues/123" --smoke
+
+# Approve a capped smoke test after diagnosis (login required)
+badgr diagnose "https://github.com/org/repo/issues/123" --approve
+
+# Resume an existing case, e.g. one shared via a case link
+badgr diagnose repro_xxxxxxxx --approve
+badgr diagnose "https://aibadgr.com/repro/repro_xxxxxxxx" --approve
+
+# Machine-readable output
+badgr diagnose "https://github.com/org/repo/issues/123" --json
+```
+
+| Flag | Description |
+|------|-------------|
+| `--smoke` | Free. Runs real, cheap mechanical validation of the produced command (syntax, CLI-entrypoint corroboration, referenced-file presence, Docker `ENTRYPOINT`/`CMD` consistency, required env vars, plus a client-side check of any local file path you pasted). Never starts a GPU, never requires login. Combine with `--approve` — the smoke checks print first, then the normal approve flow runs. Not the same as `badgr run --smoke`, which launches a real, billable GPU job |
+| `--approve` | Approve the capped smoke test after diagnosis (opens browser sign-in automatically if not logged in) |
+| `--docker <image>` | Force Docker-image intake (override auto-detect) |
+| `--repo <url>` | Force repository intake (override auto-detect) |
+| `--comfyui <path>` | Force ComfyUI workflow intake (override auto-detect) |
+| `--github <url>` | Include a GitHub issue URL found inside pasted text as additional context (opt-in, never fetched automatically) |
+| `--json` | Machine-readable JSON output |
+
+Every run prints one status: `NEEDS INFO` (fields still missing) →
+`READY` (complete evidence-backed command, no smoke run) → `SMOKE CHECKED`
+(`--smoke` ran, every applicable check passed or was skipped) / `INVALID`
+(`--smoke` ran and a check actually failed) → `VERIFIED` (reserved for an
+actual successful GPU-provisioned run — never assigned from static
+resolution or `--smoke`). `READY`/`SMOKE CHECKED` results also print the
+canonical `badgr run`/`badgr serve` command `--approve` would run, plus a
+shareable case link — pass that case ID or URL back into `badgr diagnose
+<case_id_or_url> --approve` to resume the same case without re-diagnosing.
+
+`badgr run-issue` is an alias for `badgr diagnose`, matching the
+[aibadgr.com/run-issue](https://aibadgr.com/run-issue) Badgr Smoke Test
+web flow.
+
+---
+
 ## Commands
 
 ```text
 login
 connect
 doctor
+diagnose
 run
 launch
-task
+job
 serve
 status
 logs
 pull
 artifacts
 down
+restart
+rerun
+heartbeat
 receipts
 test
 ```
@@ -183,19 +242,23 @@ test
 | `badgr login` | Save API key to `~/.badgr/config.json` |
 | `badgr connect <provider>` | Store a provider credential (`anthropic`, `openai`) for `badgr launch` |
 | `badgr doctor` | Diagnose a GPU workload failure — read-only, no login needed |
+| `badgr diagnose "<input>"` | Run a Badgr Smoke Test on a GitHub issue, Docker image, repo, log, or workflow — free, no GPU until `--approve` |
 | `badgr run <command>` | Run a one-off GPU job (any container command) |
 | `badgr launch cline\|claude\|codex\|playwright "<task>"` | Run a coding/testing agent on a CPU VM — image + command auto-selected |
-| `badgr task "<desc>" -- <command>` | Label + launch — thin wrapper over `badgr launch . -- <command>` |
+| `badgr job <agent> "<instruction>" --check "<cmd>"` | Tracked coding-agent job via `POST /v1/jobs` (type: agent) |
 | `badgr serve <model>` | Start a persistent OpenAI-compatible endpoint |
 | `badgr status` | Show what's running and what's billing |
 | `badgr logs <id>` | Fetch log output from a deployment |
 | `badgr pull <id>` | Pull a code-editing agent's patch as a local git diff/branch |
 | `badgr artifacts <id>` | Download non-patch outputs (test reports, screenshots, traces) |
 | `badgr down <id>` | Terminate a deployment — stops billing immediately |
+| `badgr restart <id>` | Relaunch an endpoint with the same config, on a new deployment ID, keeping its API key |
+| `badgr rerun <id>` | Replay a past job or endpoint with its exact original spec, on a new deployment ID |
+| `badgr heartbeat <id>` | Reset an endpoint's idle-timeout clock (see `--idle-timeout` under [`badgr serve` options](#badgr-serve-options)) |
 | `badgr receipts [n]` | Cost, route, and retry receipts (default 10) |
 | `badgr test` | Run an end-to-end test (provision → run → teardown) |
 
-More commands below, under [Advanced](#advanced): `comfyui`, `train`, `transcribe`, `embed`, `workload`, `workspace`, `batch`, `sbatch`, `capacity`, `billing`.
+More commands below, under [Advanced](#advanced): `comfyui`, `train`, `transcribe`, `embed`, `workload`, `workspace`, `batch`, `sbatch`, `capacity`, `billing`, `models`, `template`.
 
 `badgr serve` — for anything that needs a persistent endpoint: LLM serving, embeddings, image generation APIs, transcription APIs.
 
@@ -228,16 +291,38 @@ Each command section below lists only its own extra flags.
 badgr serve meta-llama/Llama-3.1-8B-Instruct --gpu L40S --region EU
 ```
 
+Endpoints bill continuously, so `serve` requires either `--max-cost` or `--persistent` (or `--dry-run` to just preview) — it refuses to start otherwise.
+
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--image <img>` | — | Serve a custom container instead of a HuggingFace model |
 | `--task <task>` | — | vLLM task override, e.g. `embed` for embedding models |
-| `--health-path <path>` | auto | Readiness path to poll (auto-detected for ComfyUI → `/system_stats`) |
+| `--runtime llama.cpp\|ollama` | vLLM | Serve via a different runtime instead of vLLM |
+| `--hf-repo <repo>` | — | HuggingFace repo for a GGUF file (with `--runtime llama.cpp`), e.g. `org/model-repo` |
+| `--hf-file <file>` | — | GGUF filename within that repo, e.g. `model.gguf` (required with `--runtime llama.cpp`) |
+| `--idle-timeout <min>` | — | Auto-stop after N minutes with no `badgr heartbeat` call — see [`badgr heartbeat`](#badgr-heartbeat) |
+| `--persistent` | off | Run until manually stopped — satisfies the cost-control requirement in place of `--max-cost` |
+| `--check-nodes <n1,n2>` | — | For ComfyUI-shaped images: verify custom nodes are installed after startup |
+| `--health-path <path>` | auto | Readiness path to poll (auto-detected: ComfyUI → `/system_stats`, llama.cpp → `/health`) |
 | `--no-wait` | off | Skip endpoint health check and return immediately |
+| `--yes` / `-y` | off | Skip duplicate-deployment warning |
+| `--dry-run` | — | Preview the plan (GPU, price) without provisioning |
 | `--list-aliases` | — | List blessed vLLM model aliases (`qwen-7b`, `llama-8b`, `qwen-coder-7b`) and exit — no provisioning, no API key required |
 
 Blessed aliases expand to a full model ID + preset GPU, e.g. `badgr serve qwen-7b` → `Qwen/Qwen2.5-7B-Instruct` on an RTX 4090. Run `badgr serve --list-aliases` to see the current list.
 
+```bash
+# Serve a Hugging Face GGUF file via llama.cpp instead of vLLM
+badgr serve --runtime llama.cpp --hf-repo org/model-repo --hf-file model.gguf --max-cost 10
+
+# Serve Open WebUI, a chat UI, pointed at a model endpoint
+badgr serve openwebui --model qwen-7b --max-cost 10
+badgr serve openwebui --connect <existing-endpoint-url>   # connect to an endpoint you already have
+
+# Auto-stop only when idle — requires periodic badgr heartbeat calls to stay up
+badgr serve qwen-7b --idle-timeout 30 --max-cost 10
+```
+
 ### Model support levels
 
 `badgr serve qwen-7b` is the happy path — a tested route with no extra setup. `badgr serve` also accepts any other model ID or a custom container:
@@ -269,10 +354,21 @@ badgr run . --image mycompany/custom:latest --cmd "python train.py" --max-cost 5
 
 Badgr zips and uploads the folder (Flow 1) or clones the repo (Flow 2), picks a generic runner, installs deps, runs the command, stores outputs for 48 hours, and tears down the GPU. `--max-cost` is required.
 
+```bash
+# No GPU needed — run on a plain CPU VM instead
+badgr run . --cmd "npm test" --no-gpu --max-cost 1
+
+# Describe basic compute needs instead of a GPU model — Badgr finds a compatible machine
+badgr run . --cpu 16 --memory 64GB --gpu-memory 24GB --max-cost 5
+```
+
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--cmd <command>` | — | Command to run inside the uploaded project or cloned repo (required for folder/GitHub flows) |
-| `--min-vram <GB>` | — | Minimum VRAM in GB — optional constraint for Auto routing |
+| `--min-vram <GB>` | — | Minimum VRAM in GB — optional constraint for Auto routing (alias: `--gpu-memory`) |
+| `--cpu <cores>` | — | Minimum CPU cores (for a CPU-only run) |
+| `--memory <size>` | — | Minimum RAM, e.g. `64GB` |
+| `--no-gpu` | off | Run on a CPU-only VM — no GPU is provisioned (conflicts with `--gpu`/`--min-vram`) |
 | `--image <img>` | — | Custom Docker image — bypasses the runner |
 | `--max-runtime <min>` | — | Auto-stop after N minutes |
 | `--save <name>` | — | Save this job as a named workload after it completes |
@@ -320,13 +416,14 @@ Productized batch image generation — runs a list of prompts through a **blesse
 ```bash
 badgr comfyui batch --workflow sdxl-basic --prompts prompts.txt --max-cost 10
 badgr comfyui batch --workflow sdxl-basic --prompt "a cat on a beach" --prompt "a dog in the park" --max-cost 5
+badgr comfyui batch --workflow flux-basic --prompt "a neon city at night" --max-cost 5
 ```
 
-Blessed workflows: `sdxl-basic` (SDXL text-to-image, default sampler settings). Max 20 prompts per batch.
+Blessed workflows: `sdxl-basic` (SDXL text-to-image, default sampler settings), `flux-basic` (FLUX.1-schnell text-to-image). Max 20 prompts per batch.
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--workflow <name>` | — | Blessed workflow ID (required) — currently `sdxl-basic` |
+| `--workflow <name>` | — | Blessed workflow ID (required) — `sdxl-basic` or `flux-basic` |
 | `--prompts <file>` | — | Text file, one prompt per line |
 | `--prompt <text>` | — | Inline prompt (repeatable) — combine with `--prompts` if needed |
 | `--max-runtime <min>` | 60 | Auto-stop after N minutes |
@@ -350,6 +447,37 @@ Each receipt includes runtime, estimated/settled cost, status, retries, teardown
 
 ---
 
+## Managing a deployment
+
+```bash
+badgr status                          # what's running and billing
+badgr logs dep-abc123                 # fetch current log output
+badgr logs dep-abc123 --follow        # stream logs until the deployment reaches a terminal state
+badgr pull dep-abc123                 # pull a coding agent's patch as a local git diff
+badgr pull dep-abc123 --branch        # ...as a new local branch instead of a diff
+badgr pull dep-abc123 --diff-only     # print the diff, don't touch the working tree
+badgr artifacts dep-abc123            # download non-patch outputs (test reports, screenshots, traces)
+badgr down dep-abc123                 # terminate one deployment, stop billing
+badgr down --all                      # terminate everything running, with a confirmation prompt
+badgr down --all --yes                # ...skip the confirmation prompt
+badgr restart dep-abc123              # relaunch an endpoint with the same config — new ID, same API key
+badgr rerun dep-abc123                # replay a past job/endpoint with its exact original spec — new ID
+badgr heartbeat dep-abc123            # reset an endpoint's idle-timeout clock (see --idle-timeout on badgr serve)
+```
+
+| Command | Flag | Description |
+|---------|------|-------------|
+| `badgr logs <id>` | `--follow` / `-f` | Stream/poll logs until the deployment reaches a terminal state instead of a one-shot fetch |
+| `badgr pull <id>` | `--branch` | Create a new local git branch from the patch instead of leaving it as an unstaged diff |
+| `badgr pull <id>` | `--diff-only` | Print the raw diff, don't touch the local working tree at all |
+| `badgr pull <id>` | `--yes` / `-y` | Skip the confirmation prompt before applying |
+| `badgr down <id\|--all>` | `--all` | Terminate every running deployment instead of one by ID |
+| `badgr down <id\|--all>` | `--yes` / `-y` | Skip the confirmation prompt |
+
+`badgr restart` is endpoint-only (it tears down the current pod and relaunches with the same GPU/model/price/runtime caps and endpoint API key, so existing clients keep working against a new URL). `badgr rerun` works for both one-off jobs and endpoints, replaying the exact original image/command/env/GPU/caps, and never tears down the source deployment.
+
+---
+
 ## OpenAI compatibility
 
 `badgr serve` provisions a vLLM endpoint that is fully OpenAI-compatible:
@@ -417,22 +545,26 @@ Less common commands — training, transcription, embeddings, and the workload/w
 badgr train config.yaml --gpu A100 --max-runtime 240 --env HF_TOKEN=$HF_TOKEN
 ```
 
-Detects framework (axolotl, unsloth, trl) from the config file, but **only Axolotl configs run today** — `unsloth`/`trl`/unrecognized configs are blocked before provisioning rather than billing a GPU that's guaranteed to fail. Default max-runtime is 120 min.
+Detects framework (axolotl, unsloth, trl) from the config file. **Axolotl and TRL configs run today** — `unsloth`/unrecognized configs are blocked before provisioning rather than billing a GPU that's guaranteed to fail. Default max-runtime is 120 min.
 
 ```bash
 badgr train lora --base-model mistralai/Mistral-7B-v0.1 --dataset ./train.jsonl --preset small --max-cost 20
+
+# Resume from a prior job's checkpoint instead of starting over
+badgr train lora --base-model mistralai/Mistral-7B-v0.1 --dataset ./train.jsonl --resume https://.../checkpoint --max-cost 20
 ```
 
 Productized LoRA training — pass a base model and dataset, no Axolotl config file needed. Badgr generates the config from a preset and returns a downloadable adapter.
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--framework <name>` | auto-detect | Force framework: `axolotl`, `unsloth`, `trl` (only `axolotl` currently runs) |
+| `--framework <name>` | auto-detect | Force framework: `axolotl`, `unsloth`, `trl` (`axolotl`/`trl` currently run; `unsloth` is blocked pre-provisioning) |
 | `--base-model <id>` | — | HuggingFace model ID (required for `train lora`) — validated to exist before provisioning |
 | `--dataset <path\|url>` | — | Local file, direct URL, or `s3://` URI |
 | `--file-id <id>` | — | Badgr upload ID instead of `--dataset` |
 | `--preset small\|medium` | `small` | `small` = RTX 4090, rank 16, 3 epochs. `medium` = A100, rank 32, 5 epochs |
 | `--gpu-type <type>` | preset default | GPU type override for `train lora` |
+| `--resume <checkpoint-url>` | — | Continue training from a prior job's checkpoint instead of starting fresh |
 | `--dry-run` | — | Preview the job without provisioning |
 
 On completion, `train lora` prints an `adapter_url` — download with `GET /v1/jobs/{job_id}/adapter`, or via `badgr workload info` if saved.
@@ -502,8 +634,11 @@ badgr batch status dep-abc123
 badgr batch artifacts dep-abc123
 badgr batch receipt dep-abc123
 badgr batch compare dep-abc123 dep-def456
+badgr batch compare dep-abc123 dep-def456 --key accuracy --higher-is-better
 ```
 
+`batch compare` reads each run's `success_metric` by default; `--key <metric>` compares a different field from the receipt instead, and `--higher-is-better` (default) / `--higher-is-better false` controls which run is reported as the winner.
+
 For CV/video/scientific batch, simulation, and physical-AI eval workloads — runs a container from a `workload.yml` spec and captures output artifacts automatically.
 
 **Fan-out** — run the same program once per file in a directory, one deployment per input, in parallel:
@@ -539,14 +674,44 @@ Translates `--cpus-per-task`/`--mem`/`--gres`/`--time`/`--export` from a real `.
 | `--max-concurrency <n>` | 5 | Cap in-flight array tasks |
 | `--dry-run` | — | Preview the translated job without provisioning |
 
-### Other commands
+### `badgr models` — GPU catalog and pricing
+
+```bash
+badgr models
+```
+
+Lists available GPU types cheapest-first, with VRAM and hourly rate — pulled live from your account when logged in, falling back to the local catalog otherwise. No flags.
 
-- `badgr capacity [--gpu <type>]` — check available GPU capacity right now
-- `badgr billing status` / `badgr billing add <amount>` — check balance / add funds
+### `badgr template` — pre-built workload templates
+
+```bash
+badgr template list
+badgr template info axolotl
+badgr serve template vllm --model meta-llama/Llama-3.1-8B-Instruct --max-cost 10
+badgr run template axolotl --config ./config.yaml --max-cost 10
+```
+
+Provider-neutral templates for common frameworks (`vllm`, `invokeai`, `comfyui`, `axolotl`, `unsloth`, …). `template list`/`template info <name>` just browse the catalog; launching always goes through `badgr serve template <name>` or `badgr run template <name>`, which apply the template's default flags before handing off to the normal `serve`/`run` path.
+
+### `badgr capacity` — check live availability
+
+```bash
+badgr capacity                              # cheapest runnable GPU across all types
+badgr capacity --gpu A100                   # a specific GPU type
+badgr capacity --gpu A100 --region EU       # region-filtered
+badgr capacity --gpu A100 --max-price 2.50  # price-capped
+```
+
+### `badgr billing`
+
+```bash
+badgr billing status         # current balance
+badgr billing add 20         # add funds — $5 minimum top-up
+```
 
 ---
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 20.10+
 - A Badgr account — sign up at [aibadgr.com](https://aibadgr.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "badgr-cli",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Badgr — run or serve GPU workloads from one command",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
     "archiver": "^7.0.1",
+    "badgr-shared": "0.1.1",
     "chalk": "^5.3.0",
     "js-yaml": "^4.1.0",
     "tar": "^7.4.3"

package/src/badgr.js

@@ -9,7 +9,7 @@ import { logsCommand }       from './commands/logs.js';
 import { receiptsCommand }   from './commands/receipts.js';
 import { runCommand }        from './commands/run.js';
 import { launchCommand }     from './commands/launch.js';
-import { taskCommand }       from './commands/task.js';
+import { jobCommand }        from './commands/job.js';
 import { artifactsCommand }  from './commands/artifacts.js';
 import { serveCommand }      from './commands/serve.js';
 import { modelsCommand }     from './commands/models.js';
@@ -31,6 +31,7 @@ import { rerunCommand }      from './commands/rerun.js';
 import { heartbeatCommand }  from './commands/heartbeat.js';
 import { pullCommand }       from './commands/pull.js';
 import { doctorCommand }     from './commands/doctor.js';
+import { diagnoseCommand }   from './commands/diagnose.js';
 import { connectCommand }    from './commands/connect.js';
 
 const HELP = `
@@ -43,10 +44,11 @@ ${chalk.bold('COMMANDS')}
   ${chalk.cyan('badgr run <command>')}       Run a one-off GPU job
   ${chalk.cyan('badgr launch cline|claude|codex|playwright "<task>"')}  Run a coding/testing workload on a CPU VM — image + command auto-selected
   ${chalk.cyan('badgr launch <source> -- <command>')}  Advanced escape hatch: run any other command on a CPU VM
-  ${chalk.cyan('badgr task "<desc>" -- <command>')}    Label + launch — thin wrapper over badgr launch . -- <command>
+  ${chalk.cyan('badgr job <agent> "<instruction>" --check "<command>"')}  Bounded coding-agent job, tracked at /jobs (POST /v1/jobs, type: agent)
   ${chalk.cyan('badgr serve <model>')}       Serve a model with an OpenAI-compatible endpoint
   ${chalk.cyan('badgr serve openwebui')}     Serve Open WebUI — chat UI, connects to a model endpoint
-  ${chalk.cyan('badgr doctor')}              Diagnose why a GPU workload is likely failing (read-only, no login needed)
+  ${chalk.cyan('badgr diagnose "<input>"')}   Run a free Badgr Smoke Test on any GPU issue — GitHub issue, Docker image, log, repo, or text
+  ${chalk.cyan('badgr doctor')}              Local GPU / model-fit diagnosis (read-only, no login needed)
   ${chalk.cyan('badgr status')}              Show what's running and what's billing
   ${chalk.cyan('badgr logs <id>')}           Stream logs for a running job or endpoint
   ${chalk.cyan('badgr pull <id>')}           Safely pull cloud-agent patch artifacts
@@ -108,10 +110,18 @@ ${chalk.bold('EXAMPLES')}
   badgr launch https://github.com/user/repo --max-cost 1 -- python narrgo.py
   badgr artifacts <id>
 
-  ${chalk.dim('# badgr task is a thin label wrapper over badgr launch . -- <command>:')}
-  badgr task "Run the Chromium tests and tell me what failed" --max-cost 1 -- npm run test:chromium
+  ${chalk.dim('# badgr job — bounded coding-agent job with a pass/fail check, tracked at /jobs:')}
+  badgr job cline "Run the Chromium tests and tell me what failed" --check "npm run test:chromium" --max-cost 1
 
-  ${chalk.dim('# Diagnose why a GPU workload is likely failing (local, read-only, no login):')}
+  ${chalk.dim('# Run a free Badgr Smoke Test on any GPU issue (no login needed):')}
+  badgr diagnose "https://github.com/org/repo/issues/123"
+  badgr diagnose ./error.log
+  badgr diagnose --docker ajayrajtp/vllm_gemma412b:latest
+  badgr diagnose --repo https://github.com/org/repo
+  badgr diagnose --comfyui workflow.json
+  badgr diagnose "https://github.com/org/repo/issues/123" --approve ${chalk.dim('# approve a capped smoke test')}
+
+  ${chalk.dim('# Local model-fit and workload diagnosis (no network):')}
   badgr doctor
   badgr doctor --model Qwen/Qwen2.5-7B-Instruct --serve
   badgr doctor --logs ./vllm.log
@@ -195,6 +205,10 @@ ${chalk.bold('badgr run OPTIONS')}
   --no-gpu               Run on a CPU-only VM — no GPU is provisioned (conflicts with --gpu/--gpu-memory)
   --tier 1               Managed provider routing (default)
   --tier 2               Marketplace provider routing, lower-cost options
+  --smoke                Cheapest compatible provider for a local/dev test run — defaults: $0.25
+                         max cost, 10min max runtime (override with --max-cost/--max-runtime).
+                         Always: one attempt, mandatory teardown, no --workspace.
+                         Same as setting BADGR_DEV_CHEAPEST=1. An explicit --tier overrides this.
   --image <image>        Docker image (default: python:3.11-slim)
   --env KEY=VALUE        Set an environment variable (repeatable)
   --count <n>            Number of GPUs (default: 1)
@@ -270,7 +284,7 @@ async function main() {
     case 'detect':   return detectCommand(config, rest, chalk);
     case 'run':      return runCommand(config, rest, chalk);
     case 'launch':   return launchCommand(config, rest, chalk);
-    case 'task':     return taskCommand(config, rest, chalk);
+    case 'job':      return jobCommand(config, rest, chalk);
     case 'artifacts': return artifactsCommand(config, rest, chalk);
     case 'pull':     return pullCommand(config, rest, chalk);
     case 'serve':    return serveCommand(config, rest, chalk);
@@ -280,7 +294,9 @@ async function main() {
     case 'restart':   return restartCommand(config, rest, chalk);
     case 'rerun':     return rerunCommand(config, rest, chalk);
     case 'heartbeat': return heartbeatCommand(config, rest, chalk);
-    case 'doctor':    return doctorCommand(config, rest, chalk);
+    case 'diagnose':    return diagnoseCommand(config, rest, chalk);
+    case 'run-issue':   return diagnoseCommand(config, rest, chalk); // alias — matches the /run-issue web flow name
+    case 'doctor':      return doctorCommand(config, rest, chalk);
     case 'receipts': return receiptsCommand(config, rest, chalk);
     case 'models':   return modelsCommand(config, chalk);
     case 'capacity': return capacityCommand(config, rest, chalk);

package/src/commands/billing.js

@@ -7,7 +7,7 @@ badgr billing — manage your AI Badgr balance
 
 COMMANDS
   badgr billing status         Show current balance
-  badgr billing add <amount>   Open checkout to add balance (minimum $10)
+  badgr billing add <amount>   Open checkout to add balance (minimum $5)
 
 EXAMPLES
   badgr billing status
@@ -49,8 +49,8 @@ async function billingStatus(config, chalk) {
 async function billingAdd(config, amount, chalk) {
   requireApiKey(config);
   const amountInt = parseInt(amount, 10);
-  if (!amountInt || amountInt < 10) {
-    console.error(chalk.red('  Minimum top-up is $10. Example: badgr billing add 10'));
+  if (!amountInt || amountInt < 5) {
+    console.error(chalk.red('  Minimum top-up is $5. Example: badgr billing add 5'));
     process.exit(1);
   }
 

package/src/commands/connect.js

@@ -79,5 +79,8 @@ export async function connectCommand(args, chalk, deps = {}) {
   setCredential(provider, key);
   console.log(chalk.green(`\n  ✓ ${alreadyConnected ? 'Updated' : 'Connected'} ${provider}`));
   console.log(chalk.dim(`  Stored in ${CREDENTIALS_FILE} (owner-only file permissions)`));
-  console.log(chalk.dim(`  Used automatically by: badgr launch ${provider === 'anthropic' ? 'claude' : provider === 'openai' ? 'codex' : provider} "<task>"\n`));
+  const usageHint = provider === 'anthropic' ? 'badgr launch claude "<task>"'
+    : provider === 'openai' ? 'badgr launch codex "<task>"'
+    : `badgr launch cline/claude/codex --provider ${provider} --model <model-id> "<task>"`;
+  console.log(chalk.dim(`  Used automatically by: ${usageHint}\n`));
 }