refactor(cli): rename scripts→cli, add jsonargparse with --config YAML support

README.md

@@ -75,11 +75,11 @@ Prefer the terminal? Point `trackers track` at a video, webcam feed, RTSP stream
 ```bash
 trackers track \
     --source video.mp4 \
-    --output output.mp4 \
-    --model rfdetr-medium \
+    --out.output output.mp4 \
+    --detection.model rfdetr-medium \
     --tracker bytetrack \
-    --show-labels \
-    --show-trajectories
+    --show.labels \
+    --show.trajectories
 ```
 
 For all CLI options, see the [tracking guide](https://trackers.roboflow.com/develop/learn/track/).
@@ -103,10 +103,10 @@ Once you have tracking results, you want to know how good they are. `trackers ev
 
 ```bash
 trackers eval \
-    --gt-dir ./data/mot17/val \
-    --tracker-dir results \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1
+    --gt_dir ./data/mot17/val \
+    --tracker_dir results \
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]'
 ```
 
 ```
@@ -130,7 +130,7 @@ For the full evaluation workflow, see the [evaluation guide](https://trackers.ro
 Need benchmark data to evaluate against? `trackers download` pulls MOT17, SportsMOT, and other supported datasets with a single command, handling splits and assets selectively so you only download what you need.
 
 ```bash
-trackers download mot17 \
+trackers download --dataset mot17 \
     --split val \
     --asset annotations,detections
 ```

docs/index.md

@@ -41,11 +41,11 @@ Point at a video, webcam, RTSP stream, or image directory. Get tracked output.
 ```bash
 trackers track \
     --source video.mp4 \
-    --output output.mp4 \
-    --model rfdetr-medium \
+    --out.output output.mp4 \
+    --detection.model rfdetr-medium \
     --tracker bytetrack \
-    --show-labels \
-    --show-trajectories
+    --show.labels \
+    --show.trajectories
 ```
 
 For all CLI options, see the [tracking guide](learn/track.md).
@@ -86,10 +86,10 @@ Benchmark your tracker against ground truth with standard MOT metrics.
 
 ```text
 trackers eval \
-    --gt-dir ./data/mot17/val \
-    --tracker-dir results \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1
+    --gt_dir ./data/mot17/val \
+    --tracker_dir results \
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]'
 ```
 
 ```
@@ -130,7 +130,7 @@ For detailed benchmarks and tuned configurations, see the [tracker comparison](t
 Pull benchmark datasets for evaluation with a single command.
 
 ```bash
-trackers download mot17 \
+trackers download --dataset mot17 \
     --split val \
     --asset annotations,detections
 ```

docs/learn/detection-quality.md

@@ -47,7 +47,8 @@ We pick three models that span a wide accuracy range on COCO, from a lightweight
 Pull the MOT17 validation split. You need frames for detection and annotations for evaluation.
 
 ```text
-trackers download mot17 \
+trackers download \
+    --dataset mot17 \
     --split val \
     --asset frames,annotations \
     --output ./data
@@ -66,10 +67,10 @@ Run ByteTrack with default parameters three times, changing only the detection m
     ```bash
     trackers track \
         --source ./data/mot17/val/MOT17-13-FRCNN/img1 \
-        --model yolo26n-640 \
+        --detection.model yolo26n-640 \
         --tracker bytetrack \
-        --classes person \
-        --mot-output results/yolo26n/MOT17-13-FRCNN.txt
+        --filters.classes person \
+        --out.mot_results results/yolo26n/MOT17-13-FRCNN.txt
     ```
 
 === "All sequences"
@@ -78,10 +79,10 @@ Run ByteTrack with default parameters three times, changing only the detection m
     for seq in MOT17-02-FRCNN MOT17-04-FRCNN MOT17-05-FRCNN MOT17-09-FRCNN MOT17-10-FRCNN MOT17-11-FRCNN MOT17-13-FRCNN; do
         trackers track \
             --source ./data/mot17/val/$seq/img1 \
-            --model yolo26n-640 \
+            --detection.model yolo26n-640 \
             --tracker bytetrack \
-            --classes person \
-            --mot-output results/yolo26n/$seq.txt
+            --filters.classes person \
+            --out.mot_results results/yolo26n/$seq.txt
     done
     ```
 
@@ -97,10 +98,10 @@ Run ByteTrack with default parameters three times, changing only the detection m
     ```bash
     trackers track \
         --source ./data/mot17/val/MOT17-13-FRCNN/img1 \
-        --model rfdetr-nano \
+        --detection.model rfdetr-nano \
         --tracker bytetrack \
-        --classes person \
-        --mot-output results/rfdetr-nano/MOT17-13-FRCNN.txt
+        --filters.classes person \
+        --out.mot_results results/rfdetr-nano/MOT17-13-FRCNN.txt
     ```
 
 === "All sequences"
@@ -109,10 +110,10 @@ Run ByteTrack with default parameters three times, changing only the detection m
     for seq in MOT17-02-FRCNN MOT17-04-FRCNN MOT17-05-FRCNN MOT17-09-FRCNN MOT17-10-FRCNN MOT17-11-FRCNN MOT17-13-FRCNN; do
         trackers track \
             --source ./data/mot17/val/$seq/img1 \
-            --model rfdetr-nano \
+            --detection.model rfdetr-nano \
             --tracker bytetrack \
-            --classes person \
-            --mot-output results/rfdetr-nano/$seq.txt
+            --filters.classes person \
+            --out.mot_results results/rfdetr-nano/$seq.txt
     done
     ```
 
@@ -128,10 +129,10 @@ Run ByteTrack with default parameters three times, changing only the detection m
     ```bash
     trackers track \
         --source ./data/mot17/val/MOT17-13-FRCNN/img1 \
-        --model rfdetr-medium \
+        --detection.model rfdetr-medium \
         --tracker bytetrack \
-        --classes person \
-        --mot-output results/rfdetr-medium/MOT17-13-FRCNN.txt
+        --filters.classes person \
+        --out.mot_results results/rfdetr-medium/MOT17-13-FRCNN.txt
     ```
 
 === "All sequences"
@@ -140,10 +141,10 @@ Run ByteTrack with default parameters three times, changing only the detection m
     for seq in MOT17-02-FRCNN MOT17-04-FRCNN MOT17-05-FRCNN MOT17-09-FRCNN MOT17-10-FRCNN MOT17-11-FRCNN MOT17-13-FRCNN; do
         trackers track \
             --source ./data/mot17/val/$seq/img1 \
-            --model rfdetr-medium \
+            --detection.model rfdetr-medium \
             --tracker bytetrack \
-            --classes person \
-            --mot-output results/rfdetr-medium/$seq.txt
+            --filters.classes person \
+            --out.mot_results results/rfdetr-medium/$seq.txt
     done
     ```
 
@@ -162,10 +163,10 @@ Evaluate each run against ground truth using CLEAR, HOTA, and Identity metrics.
 
 ```text
 trackers eval \
-    --gt-dir ./data/mot17/val \
-    --tracker-dir results/yolo26n \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1
+    --gt_dir ./data/mot17/val \
+    --tracker_dir results/yolo26n \
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]'
 ```
 
 **Output:**
@@ -180,10 +181,10 @@ COMBINED                      23.444  32.874  34.411
 
 ```text
 trackers eval \
-    --gt-dir ./data/mot17/val \
-    --tracker-dir results/rfdetr-nano \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1
+    --gt_dir ./data/mot17/val \
+    --tracker_dir results/rfdetr-nano \
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]'
 ```
 
 **Output:**
@@ -198,10 +199,10 @@ COMBINED                      25.667  35.735  38.182
 
 ```text
 trackers eval \
-    --gt-dir ./data/mot17/val \
-    --tracker-dir results/rfdetr-medium \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1
+    --gt_dir ./data/mot17/val \
+    --tracker_dir results/rfdetr-medium \
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]'
 ```
 
 **Output:**

docs/learn/download.md

@@ -44,10 +44,10 @@ The table below lists every dataset you can download, along with its splits, ass
 
 === "CLI"
 
-    Use `--list` to print available datasets, splits, and asset types.
+    Use `--list_available` to print available datasets, splits, and asset types.
 
     ```text
-    trackers download --list
+    trackers download --list_available
     ```
 
 === "Python"
@@ -72,7 +72,7 @@ Pass a dataset name to download all of its splits and assets.
     Download the full MOT17 dataset.
 
     ```text
-    trackers download mot17
+    trackers download --dataset mot17
     ```
 
 === "Python"
@@ -96,15 +96,15 @@ Full datasets can be large. Narrow your download to specific splits and asset ty
     Use `--split` and `--asset` to filter by split, asset type, or both.
 
     ```text
-    trackers download mot17 --split train --asset annotations
+    trackers download --dataset mot17 --split train --asset annotations
     ```
 
     ```text
-    trackers download mot17 --split train,val --asset annotations,frames
+    trackers download --dataset mot17 --split train,val --asset annotations,frames
     ```
 
     ```text
-    trackers download sportsmot --split val --asset annotations
+    trackers download --dataset sportsmot --split val --asset annotations
     ```
 
 === "Python"
@@ -152,7 +152,7 @@ Dataset files are extracted to the current directory by default. Set a custom ou
     Use `--output` to extract into a custom directory.
 
     ```text
-    trackers download mot17 \
+    trackers download --dataset mot17 \
         --split train,val \
         --asset annotations,frames \
         --output ./datasets
@@ -209,13 +209,13 @@ Every downloaded ZIP is saved to `~/.cache/trackers` and verified with an MD5 ch
 
 === "CLI"
 
-    Use `--cache-dir` to store ZIPs in a custom location.
+    Use `--cache_dir` to store ZIPs in a custom location.
 
     ```text
-    trackers download mot17 \
+    trackers download --dataset mot17 \
         --split train \
         --asset annotations \
-        --cache-dir ./my-cache
+        --cache_dir ./my-cache
     ```
 
 === "Python"
@@ -254,12 +254,12 @@ All arguments accepted by the `trackers download` command.
   </thead>
   <tbody>
     <tr>
-      <td><code>dataset</code></td>
+      <td><code>--dataset</code></td>
       <td>Dataset name to download. Options: <code>mot17</code>, <code>sportsmot</code>.</td>
       <td>—</td>
     </tr>
     <tr>
-      <td><code>--list</code></td>
+      <td><code>--list_available</code></td>
       <td>List available datasets, splits, and asset types without downloading.</td>
       <td><code>false</code></td>
     </tr>
@@ -279,7 +279,7 @@ All arguments accepted by the `trackers download` command.
       <td><code>.</code></td>
     </tr>
     <tr>
-      <td><code>--cache-dir</code></td>
+      <td><code>--cache_dir</code></td>
       <td>Directory for caching downloaded ZIP files. Cached files are verified by MD5 and reused across runs.</td>
       <td><code>~/.cache/trackers</code></td>
     </tr>

docs/learn/evaluate.md

@@ -41,7 +41,8 @@ Use `trackers download` to pull ground-truth annotations and detections from sup
     Fetch MOT17 validation annotations and detections from the command line.
 
     ```text
-    trackers download mot17 \
+    trackers download \
+        --dataset mot17 \
         --split val \
         --asset annotations,detections \
         --output ./data
@@ -89,13 +90,13 @@ For more download options, see the [download guide](download.md).
 
 Feed the pre-computed detections into a tracker and write the results to a file for evaluation.
 
-Pass `--detections` to provide input detections and `--mot-output` to save the tracker output in MOT format.
+Pass `--detection.detections` to provide input detections and `--out.mot_results` to save the tracker output in MOT format.
 
 ```text
 trackers track \
-    --detections ./data/mot17/val/MOT17-02-FRCNN/det/det.txt \
+    --detection.detections ./data/mot17/val/MOT17-02-FRCNN/det/det.txt \
     --tracker bytetrack \
-    --mot-output results/MOT17-02-FRCNN.txt
+    --out.mot_results results/MOT17-02-FRCNN.txt
 ```
 
 ---
@@ -108,8 +109,8 @@ Compare the tracker output against ground truth to compute standard MOT metrics.
 trackers eval \
     --gt ./data/mot17/val/MOT17-02-FRCNN/gt/gt.txt \
     --tracker results/MOT17-02-FRCNN.txt \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]'
 ```
 
 **Output:**
@@ -148,10 +149,10 @@ Evaluate all sequences at once and get per-sequence results plus a combined aggr
 
 ```text
 trackers eval \
-    --gt-dir ./data/mot17/val \
-    --tracker-dir results \
-    --metrics CLEAR HOTA Identity \
-    --columns MOTA HOTA IDF1 \
+    --gt_dir ./data/mot17/val \
+    --tracker_dir results \
+    --metrics '[CLEAR,HOTA,Identity]' \
+    --columns '[MOTA,HOTA,IDF1]' \
     --output results.json
 ```
 
@@ -204,12 +205,12 @@ All arguments accepted by `trackers eval`.
       <td>—</td>
     </tr>
     <tr>
-      <td><code>--gt-dir</code></td>
+      <td><code>--gt_dir</code></td>
       <td>Directory containing ground-truth files for multi-sequence evaluation.</td>
       <td>—</td>
     </tr>
     <tr>
-      <td><code>--tracker-dir</code></td>
+      <td><code>--tracker_dir</code></td>
       <td>Directory containing tracker prediction files for multi-sequence evaluation.</td>
       <td>—</td>
     </tr>