badgr-cli 1.0.39 → 1.0.40

package/README.md

@@ -46,6 +46,14 @@ badgr down <deployment-id>
 | `badgr capacity` | Check available GPU capacity right now |
 | `badgr billing` | Show balance and add funds |
 | `badgr test` | Run an end-to-end test (provision → run → teardown) |
+| `badgr workload list` | List saved workloads with run stats |
+| `badgr workload run <name>` | Rerun a saved workload by name or ID |
+| `badgr workload info <name>` | Show stats, route history, and recent jobs for a workload |
+| `badgr workload delete <name>` | Delete a saved workload |
+| `badgr workspace list` | List workspace trackers (job history + cost per context) |
+| `badgr workspace create <name>` | Create a workspace tracker, optionally linked to a storage path |
+| `badgr workspace info <name>` | Show jobs, cost, and files for a workspace |
+| `badgr workspace delete <name>` | Archive a workspace tracker |
 
 `badgr serve` — for anything that needs a persistent endpoint: LLM serving, embeddings, image generation APIs, transcription APIs.
 
@@ -101,6 +109,8 @@ badgr run python train.py --gpu A100 --env HF_TOKEN=$HF_TOKEN --max-runtime 60
 | `--max-runtime <min>` | — | Auto-stop after N minutes (recommended) |
 | `--max-cost <$>` | — | Auto-stop when total spend reaches this amount |
 | `--detach` | — | Launch and return immediately, don't stream logs |
+| `--save <name>` | — | Save this job as a named workload after it completes |
+| `--workspace <name\|id>` | — | Link this job to a workspace tracker (name or `ws_…` ID) |
 
 ---
 
@@ -199,6 +209,59 @@ Accepts a public URL, S3/GCS URI, or a local text file under 10 MB. Outputs JSON
 
 ---
 
+## Workloads
+
+A workload is a saved job configuration. Once saved, you can rerun it by name instead of retyping all the flags. Badgr tracks success rate, average cost, average runtime, and the last known-good route so reruns are faster and cheaper over time.
+
+**Save a workload** by adding `--save <name>` to any `badgr run` call:
+
+```bash
+badgr run python train.py --gpu A100 --env HF_TOKEN=$HF_TOKEN --max-runtime 120 --save my-training-job
+```
+
+**Rerun a saved workload:**
+
+```bash
+badgr workload run my-training-job
+badgr workload run my-training-job --max-cost 5          # override spend cap
+badgr workload run my-training-job --set HF_TOKEN=newval # override an env var
+```
+
+**Inspect and manage workloads:**
+
+```bash
+badgr workload list                  # list all saved workloads with stats
+badgr workload info my-training-job  # stats, route history, recent jobs
+badgr workload delete my-training-job
+```
+
+| `badgr workload run` flag | Description |
+|---|---|
+| `--max-cost <$>` | Override the saved spend cap for this run |
+| `--max-runtime <min>` | Override the saved runtime limit for this run |
+| `--set KEY=VALUE` | Override a saved config value for this run (repeatable) |
+
+---
+
+## Workspaces
+
+A workspace tracker groups jobs by a named context — useful for tracking cost and job history across a project or storage path.
+
+```bash
+badgr workspace create my-project --storage s3://my-bucket/runs --desc "nightly evals"
+badgr run python eval.py --workspace my-project --max-cost 5
+badgr workspace info my-project     # jobs, total cost, files
+badgr workspace list
+badgr workspace delete my-project
+```
+
+| `badgr workspace create` flag | Description |
+|---|---|
+| `--storage <path>` | S3/GCS path to associate with this workspace |
+| `--desc <text>` | Optional description |
+
+---
+
 ## Routing
 
 Badgr Auto selects the best eligible route based on GPU type, VRAM, availability, region, workload requirements, and reliability. Advanced users can optionally choose an execution tier or hardware constraint.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "badgr-cli",
-  "version": "1.0.39",
-  "description": "DEPRECATED: Use badgr-agent CLI instead. Badgr, run or serve GPU workloads from one command",
+  "version": "1.0.40",
+  "description": "Badgr — run or serve GPU workloads from one command",
   "type": "module",
   "bin": {
     "badgr": "src/badgr.js"
@@ -12,7 +12,8 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "badgr-agent": "1.0.0"
+    "chalk": "^5.3.0",
+    "@inquirer/prompts": "^8.5.2"
   },
   "devDependencies": {
     "vitest": "^4.1.8"
@@ -26,7 +27,12 @@
     "ai",
     "compute",
     "gateway",
-    "openai"
+    "openai",
+    "workload",
+    "workspace",
+    "llm",
+    "inference",
+    "fine-tuning"
   ],
   "license": "Apache-2.0"
 }