Validate combined release candidate

.github/workflows/checks.yml

@@ -136,6 +136,10 @@ jobs:
           python-version: "3.11"
           enable-cache: false
 
+      - name: Test launcher
+        shell: bash
+        run: bash run.sh --self-test
+
       - name: Test dashboard
         if: hashFiles('dev/gui.py') != ''
         run: uv run dev/gui.py --self-test

README.md

@@ -19,14 +19,16 @@ endpoint above downloads one temporary source archive, opens the responsive
 dashboard when `uv` and a terminal are available, and removes the archive when
 the selected command exits. Streamed use needs `curl`, `tar`, and either Python
 3.11+ or [`uv`](https://docs.astral.sh/uv/getting-started/installation/). On
-Windows, run it from Git Bash or WSL.
+Windows, use Git Bash with native Windows Python or `uv`; WSL runs the Linux
+catalog instead.
 
 The same entry point lists scripts, renders any adjacent `.man` page, or runs a
 command directly:
 
 ```sh
 RUN=https://github.com/keys-i/scripts/raw/refs/heads/main/run.sh
 curl -fsSL "$RUN" | bash -s -- list
+curl -fsSL "$RUN" | bash -s -- matrix
 curl -fsSL "$RUN" | bash -s -- man disk
 curl -fsSL "$RUN" | bash -s -- disk health
 curl -fsSL "$RUN" | bash -s -- security-audit audit --scope system
@@ -40,6 +42,7 @@ From a local checkout, use the shorter equivalents:
 ```sh
 ./run.sh
 ./run.sh list
+./run.sh matrix
 ./run.sh man disk
 ./run.sh clean
 ```

bin/_common.py

@@ -69,10 +69,12 @@ def run(
     cwd: Path | None = None,
     capture: bool = False,
     check: bool = True,
+    announce: bool = True,
     ok_codes: Sequence[int] = (0,),
     timeout: float | None = None,
 ) -> subprocess.CompletedProcess[str]:
-    print(color(f"$ {command_text(command)}", "2"), flush=True)
+    if announce:
+        print(color(f"$ {command_text(command)}", "2"), flush=True)
     try:
         result = subprocess.run(
             list(command),