rdc-cli 0.5.5__tar.gz → 0.5.6__tar.gz

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/.github/workflows/aur.yml

@@ -22,7 +22,7 @@ jobs:
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
-      - uses: KSXGitHub/github-actions-deploy-aur@2ac5a4c1d7035885d46b10e3193393be8460b6f1 # v4.1.1
+      - uses: KSXGitHub/github-actions-deploy-aur@da03e160361ce01bf087e790b6ffd196d7dccff7 # v4.1.3
         with:
           pkgname: rdc-cli-git
           pkgbuild: aur/PKGBUILD
@@ -69,7 +69,7 @@ jobs:
           sed -i "s/^pkgver=.*/pkgver=${VERSION}/" aur/stable/PKGBUILD
           sed -i "s/'PLACEHOLDER'/'${SHA256}'/" aur/stable/PKGBUILD
 
-      - uses: KSXGitHub/github-actions-deploy-aur@2ac5a4c1d7035885d46b10e3193393be8460b6f1 # v4.1.1
+      - uses: KSXGitHub/github-actions-deploy-aur@da03e160361ce01bf087e790b6ffd196d7dccff7 # v4.1.3
         with:
           pkgname: rdc-cli
           pkgbuild: aur/stable/PKGBUILD

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdc-cli
-Version: 0.5.5
+Version: 0.5.6
 Summary: CLI for RenderDoc .rdc captures
 Author: Jim
 License-Expression: MIT

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/docs-astro/src/data/commands.json

@@ -9,7 +9,7 @@
           "name": "open",
           "id": "open",
           "help": "Create local default session and start daemon skeleton.",
-          "usage": "rdc open [CAPTURE] [--preload] [--proxy HOST[:PORT]|adb://SERIAL] [--android] [--serial TEXT] [--remote HOST[:PORT]] [--listen [ADDR]:PORT] [--connect HOST:PORT] [--token TEXT] [--timeout FLOAT]"
+          "usage": "rdc open [CAPTURE] [--preload] [--proxy HOST[:PORT]|adb://SERIAL] [--android] [--serial TEXT] [--remote HOST[:PORT]] [--listen [ADDR]:PORT] [--connect HOST:PORT] [--token TEXT] [--timeout FLOAT] [--gpu INDEX|NAME|DEVICEID]"
         },
         {
           "name": "close",

rdc_cli-0.5.6/openspec/changes/2026-06-04-open-gpu-override/proposal.md

@@ -0,0 +1,83 @@
+# Add `--gpu` override to `rdc open`
+
+## Problem
+
+When a capture is replayed, the daemon picks the replay GPU automatically via
+`_match_capture_gpu()`: it matches the capture's recorded device name (Vulkan)
+or adapter description / DeviceId (D3D12), and **falls back to vendor priority
+(nVidia > AMD > Intel)** when nothing matches.
+
+On a multi-GPU host that fallback is `filtered[0]` after a stable sort, i.e. the
+first-enumerated device of the highest-priority vendor — frequently the
+integrated GPU. There is no way for the user to override it:
+
+- `rdc open` exposes no GPU selection flag.
+- The fallback cannot be steered toward a discrete GPU, a specific device, or a
+  GPU whose name does not match the capture's recorded name (common when
+  replaying a capture taken on different hardware).
+
+This complements the recent multi-GPU auto-matching work (#225) by giving the
+analyst an explicit escape hatch when auto-selection picks the wrong device.
+
+Note: an explicit GPU choice does not make a capture portable across
+incompatible hardware (RADV descriptor layouts differ per GPU generation); it
+only controls *which* available GPU replay is attempted on.
+
+## Solution
+
+Add an optional `--gpu INDEX|NAME|DEVICEID` flag to `rdc open` that forces the
+replay GPU, overriding auto-selection.
+
+Resolution order against `cap.GetAvailableGPUs()`:
+
+1. **0-based index** — `--gpu 1` selects the second enumerated GPU.
+2. **device ID** — decimal or `0x` hex (`--gpu 0x747e`), matched against
+   `GPUDevice.deviceID`.
+3. **name substring** — case-insensitive (`--gpu "7800 XT"`).
+
+If the preference matches no available GPU, a warning is logged listing the
+available GPUs and replay falls back to the existing auto-selection (non-fatal).
+
+### Plumbing
+
+The flag threads CLI → daemon, reusing the existing daemon-arg channel:
+
+- `commands/session.py`: `--gpu` option on `open_cmd`; ignored (with a warning)
+  for `--connect` (an external daemon is already running). Passed to
+  `open_session` / `listen_open_session`.
+- `services/session_service.py`: `start_daemon(..., gpu=...)` appends
+  `--gpu <value>` to the daemon argv; `open_session` / `listen_open_session`
+  forward it.
+- `daemon_server.py`: `--gpu` arg → `DaemonState.gpu_pref`; `_match_capture_gpu`
+  gains a `pref` parameter that short-circuits to the resolved GPU before
+  auto-matching. Applied at both the local and remote replay call sites.
+
+Out of scope: changing the default auto-selection (vendor priority is unchanged).
+
+## Spec Delta
+
+The existing scenario "Multi-GPU capture replay" under **Requirement: Replay
+lifecycle** in `openspec/specs/daemon/spec.md` (added by #226, amended by #230)
+is amended so the user `--gpu` preference takes precedence over auto-selection:
+
+```diff
+ #### Scenario: Multi-GPU capture replay
+ - **WHEN** the capture was taken on a multi-GPU system
+ - **AND** multiple GPUs are available for replay
+-- **THEN** the daemon walks structured-data chunks whose name contains any of
++- **THEN** if the user passed `--gpu` (a 0-based index, a PCI device ID in
++  decimal or `0x` hex, or a case-insensitive name substring) that resolves to an
++  available GPU, that GPU is selected and structured-data inspection is skipped
++- **AND** otherwise the daemon walks structured-data chunks whose name contains any of
+   "Driver Initialisation Parameters", "DriverInit", "EnumAdapters", or
+   "CreateDXGIFactory"
+ ...
+ - **AND** if no structured-data match exists, Software/WARP adapters are excluded
+   and the highest-ranked discrete GPU is preferred (nVidia > AMD > Intel)
++- **AND** an unresolved `--gpu` preference logs a warning and falls back to the
++  auto-selection above
+ - **AND** a single available GPU is always returned directly without inspection
+```
+
+This delta has been applied to `openspec/specs/daemon/spec.md` as part of this
+change.

rdc_cli-0.5.6/openspec/changes/2026-06-04-open-gpu-override/tasks.md

@@ -0,0 +1,14 @@
+# Tasks: Add `--gpu` override to `rdc open`
+
+- [x] `daemon_server.py`: add `_resolve_gpu_pref()` (index / deviceID / name substring)
+- [x] `daemon_server.py`: add `pref` param to `_match_capture_gpu()`; short-circuit before auto-match, warn + fall back when no match
+- [x] `daemon_server.py`: `--gpu` arg, `DaemonState.gpu_pref`, pass `state.gpu_pref` at local + remote call sites
+- [x] `services/session_service.py`: `start_daemon(gpu=...)` appends `--gpu`; forward through `open_session` / `listen_open_session`
+- [x] `commands/session.py`: `--gpu` option on `open_cmd`; warn-and-ignore with `--connect`; pass to open paths
+- [x] `openspec/specs/daemon/spec.md`: apply Spec Delta to the "Multi-GPU capture replay" scenario (user `--gpu` precedence + unresolved fallback)
+- [x] Unit tests: `_resolve_gpu_pref` forms; `_match_capture_gpu` pref precedence + no-match fallback warning; `start_daemon` argv; CLI passthrough + `--connect` warning
+- [x] Update existing fakes broken by new signature/attr (`test_remote_replay_passes_sd` spy, sigterm-handler `mock_args`)
+- [x] `pixi run check` green (lint + typecheck + tests)
+- [ ] Fresh review of the diff
+- [ ] Open PR targeting `master`
+- [ ] Archive this OpenSpec folder after merge

rdc_cli-0.5.6/openspec/changes/2026-06-04-open-gpu-override/test-plan.md

@@ -0,0 +1,36 @@
+# Test Plan: `--gpu` override for `rdc open`
+
+## Unit (mocked — no GPU required)
+
+`tests/unit/test_daemon_server_unit.py` (`TestMatchCaptureGpu`):
+
+1. **Index** — `pref="1"` returns the second GPU.
+2. **Name substring** — `pref="7800 xt"` matches case-insensitively.
+3. **Device ID** — `pref="29822"` (decimal) and `pref="0x747e"` (hex) both match
+   `deviceID==29822`.
+4. **Precedence** — with a Vulkan `deviceName` chunk that would auto-match GPU B,
+   `pref="AMD"` still selects GPU A.
+5. **No match** — `pref="Matrox"` logs a `--gpu` warning and falls back to the
+   vendor-priority auto-selection.
+6. **`_resolve_gpu_pref`** — index / name / hex resolve; unknown and empty → None.
+
+`tests/unit/test_session_service.py`:
+
+7. `start_daemon(gpu="1")` puts `--gpu 1` in the daemon argv; default omits `--gpu`.
+
+`tests/unit/test_session_commands.py`:
+
+8. `rdc open CAP --gpu 1` forwards `gpu="1"` to `start_daemon`.
+9. `rdc open --connect host:port --token T --gpu 1` prints
+   `warning: --gpu is ignored with --connect`.
+
+Run: `pixi run test` (unit only; no GPU/e2e). Full gate: `pixi run check`.
+
+## Manual (requires a multi-GPU host + renderdoc)
+
+- `rdc open frame.rdc --gpu <discrete-name>` then `rdc status` / a replay query;
+  daemon log shows `replay GPU (user --gpu=...)`.
+- `rdc open frame.rdc --gpu nonsense` logs the no-match warning and still opens
+  via auto-selection.
+
+(Not run in CI: needs real hardware; out of scope for the unit suite.)

rdc_cli-0.5.6/openspec/changes/archive/2026-05-17-fix-aur-deploy-action-v413/proposal.md

@@ -0,0 +1,101 @@
+# Fix AUR Deploy Action Pin: v4.1.1 → v4.1.3
+
+## Problem
+
+### Symptom
+
+`AUR Publish` workflow run 26001352704, job `Publish rdc-cli (stable)`, failed on
+the v0.5.5 tag with:
+
+```
+bash: --command: invalid option
+```
+
+The job exited before `/build.sh` ran. The `aur-git` job was not triggered (it
+fires on branch push only). The v0.5.5 PyPI release and GitHub Release were
+already shipped; the AUR `rdc-cli` package was not updated.
+
+### Root cause
+
+Both jobs pin
+`KSXGitHub/github-actions-deploy-aur@2ac5a4c1d7035885d46b10e3193393be8460b6f1`
+(v4.1.1). That action's `entrypoint.sh` ends with:
+
+```sh
+exec runuser builder --command 'bash -l -c /build.sh'
+```
+
+With the `util-linux` `runuser` binary now present in the current `archlinux:base`
+Docker image, the `--command` flag is parsed as an option to `bash` (su(1)-compat
+syntax passes the argument onward), and bash has no `--command` option. The process
+crashes before `/build.sh` ever runs.
+
+This latent bug existed in v3.0.1 through v4.1.1 of the action. Earlier workflow
+runs on v0.5.2/v0.5.3 were green because the then-current `archlinux:base` image
+did not expose the issue. A recent Arch base image update surfaced it.
+
+### Why `post_process: git checkout -B master` is innocent
+
+`build.sh` (which clones the AUR repo, evaluates `$post_process`, commits, and
+force-pushes to AUR master) is byte-identical across v4.1.1, v4.1.2, and v4.1.3.
+The crash happens in `entrypoint.sh` before `build.sh` is ever invoked, so
+`post_process` was never reached and plays no role in the failure.
+
+### Fix-forward context
+
+The v0.5.5 PyPI package and GitHub Release are already published and cannot be
+retracted. The only outstanding item is the AUR `rdc-cli` package backfill, which
+requires a successful workflow run for version 0.5.5.
+
+## Solution
+
+Bump the action pin on **both** jobs in `.github/workflows/aur.yml`:
+
+| Location | Current | After |
+|---|---|---|
+| Line 25, job `aur-git` | `2ac5a4c1d7035885d46b10e3193393be8460b6f1 # v4.1.1` | `da03e160361ce01bf087e790b6ffd196d7dccff7 # v4.1.3` |
+| Line 72, job `aur-stable` | `2ac5a4c1d7035885d46b10e3193393be8460b6f1 # v4.1.1` | `da03e160361ce01bf087e790b6ffd196d7dccff7 # v4.1.3` |
+
+All other inputs on both jobs (`force_push: true`, `post_process: git checkout -B
+master`, `pkgname`, `pkgbuild`, credential secrets) remain unchanged.
+
+v4.1.3 fixes `entrypoint.sh` to:
+
+```sh
+exec runuser -u builder -- bash -l /build.sh
+```
+
+This is the POSIX-correct `runuser` invocation that does not pass arguments to
+bash. v4.1.2 used `runuser -u builder -- bash -l -c /build.sh` (also correct);
+v4.1.3 drops the redundant `-c`.
+
+## Why the bump is safe with respect to #183 and #184
+
+The `post_process: git checkout -B master` input (PR #183, detached-HEAD fix) and
+`force_push: true` input (PR #184) are passed to `build.sh` as environment
+variables, not to `entrypoint.sh`. Because `build.sh` is byte-identical across
+v4.1.1, v4.1.2, and v4.1.3, both fixes are fully preserved by this pin bump.
+
+## Residual risk
+
+The action uses `FROM archlinux:base` with no image digest pin. A future update to
+the Arch base image could introduce a different incompatibility regardless of the
+action tag. This is inherent to the action's design; no mitigation is proposed
+here beyond monitoring workflow runs after future Arch base image refreshes.
+
+## Spec delta
+
+There is no existing spec in `openspec/specs/` covering AUR publishing or CI
+release workflows. No spec delta applies.
+
+## Post-merge backfill (operational, not a code change)
+
+After this PR merges, manually trigger `AUR Publish` via `workflow_dispatch` with
+input `version=0.5.5`. The `aur-stable` job will:
+1. Normalize version → `0.5.5`
+2. Checkout `refs/tags/v0.5.5` (already exists)
+3. `curl` the tarball and compute sha256
+4. Patch `aur/stable/PKGBUILD`
+5. Deploy to AUR via the fixed action
+
+This is the acceptance gate for this change.

rdc_cli-0.5.6/openspec/changes/archive/2026-05-17-fix-aur-deploy-action-v413/tasks.md

@@ -0,0 +1,12 @@
+# Tasks: AUR Deploy Action Pin v4.1.1 → v4.1.3
+
+- [ ] Opus review of `proposal.md` and `test-plan.md`; revise as needed
+- [ ] `.github/workflows/aur.yml` line 25: bump action pin from `2ac5a4c1d7035885d46b10e3193393be8460b6f1 # v4.1.1` to `da03e160361ce01bf087e790b6ffd196d7dccff7 # v4.1.3`
+- [ ] `.github/workflows/aur.yml` line 72: same pin bump (job `aur-stable`)
+- [ ] Static checks: grep confirms new SHA appears exactly twice, old SHA absent, both jobs retain `force_push: true` and `post_process: git checkout -B master`, YAML parses cleanly
+- [ ] Fresh review of the two-line diff
+- [ ] Open PR targeting `master`
+- [ ] After merge: trigger `AUR Publish` via `workflow_dispatch` with `version=0.5.5`
+- [ ] Verify job `Publish rdc-cli (stable)` succeeds (no `bash: --command` crash)
+- [ ] Verify AUR `rdc-cli` package shows `pkgver=0.5.5`
+- [ ] Archive this OpenSpec folder

rdc_cli-0.5.6/openspec/changes/archive/2026-05-17-fix-aur-deploy-action-v413/test-plan.md

@@ -0,0 +1,34 @@
+# Test Plan: AUR Deploy Action Pin v4.1.1 → v4.1.3
+
+There are no unit tests for a workflow YAML change. Verification is static
+inspection followed by a live workflow run.
+
+## Static verification (pre-merge)
+
+1. **Pin appears exactly twice.** `grep` for
+   `da03e160361ce01bf087e790b6ffd196d7dccff7` in
+   `.github/workflows/aur.yml` returns exactly 2 lines, one per job.
+
+2. **Old pin is absent.** `grep` for `2ac5a4c1d7035885d46b10e3193393be8460b6f1`
+   or `v4.1.1` returns no matches.
+
+3. **Version comment is present on both lines.** Both occurrences of the new SHA
+   are followed by the comment `# v4.1.3`.
+
+4. **Preserved inputs — both jobs.** `grep` confirms both jobs retain:
+   - `force_push: true`
+   - `post_process: git checkout -B master`
+
+5. **YAML parses cleanly.** `python3 -c "import yaml, sys; yaml.safe_load(sys.stdin)"
+   < .github/workflows/aur.yml` exits 0. (The repo does not include actionlint or
+   yamllint; Python's yaml module is the available static check.)
+
+## Live verification (post-merge)
+
+6. **workflow_dispatch v0.5.5 succeeds.** Trigger `AUR Publish` via
+   `workflow_dispatch` with input `version=0.5.5`. Job `Publish rdc-cli (stable)`
+   must complete with a green check — specifically, the `entrypoint.sh` crash
+   (`bash: --command: invalid option`) must not appear.
+
+7. **AUR package updated.** After the dispatch run, the AUR `rdc-cli` package page
+   shows `pkgver=0.5.5`. This is the acceptance gate.

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/openspec/specs/daemon/spec.md

@@ -38,7 +38,10 @@ ReplayController for the duration of the session.
 #### Scenario: Multi-GPU capture replay
 - **WHEN** the capture was taken on a multi-GPU system
 - **AND** multiple GPUs are available for replay
-- **THEN** the daemon walks structured-data chunks whose name contains any of
+- **THEN** if the user passed `--gpu` (a 0-based index, a PCI device ID in
+  decimal or `0x` hex, or a case-insensitive name substring) that resolves to an
+  available GPU, that GPU is selected and structured-data inspection is skipped
+- **AND** otherwise the daemon walks structured-data chunks whose name contains any of
   "Driver Initialisation Parameters", "DriverInit", "EnumAdapters", or
   "CreateDXGIFactory"
 - **AND** within each such chunk descends recursively (depth ≤ 5) to locate an
@@ -49,6 +52,8 @@ ReplayController for the duration of the session.
   DeviceId match is found
 - **AND** if no structured-data match exists, Software/WARP adapters are excluded
   and the highest-ranked discrete GPU is preferred (nVidia > AMD > Intel)
+- **AND** an unresolved `--gpu` preference logs a warning and falls back to the
+  auto-selection above
 - **AND** a single available GPU is always returned directly without inspection
 
 ### Requirement: Navigation methods

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc/_skills/references/commands-quick-ref.md

@@ -644,6 +644,7 @@ Create local default session and start daemon skeleton.
 | `--connect` | Connect to an already-running external daemon. | text |  |
 | `--token` | Authentication token (required with --connect). | text |  |
 | `--timeout` | Daemon startup timeout in seconds. | float |  |
+| `--gpu` | Force the replay GPU by 0-based index, name substring, or device ID (overrides auto-selection). | text |  |
 
 ## `rdc pass`
 

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc/commands/doctor.py

@@ -61,6 +61,14 @@ def _import_renderdoc() -> tuple[Any | None, CheckResult]:
                 False,
                 f"incompatible at {diag.candidate_path} -- rebuild renderdoc for current Python",
             )
+        if diag is not None and diag.result == ProbeResult.IMPORT_FAILED:
+            return None, CheckResult(
+                "renderdoc-module",
+                False,
+                f"found at {diag.candidate_path} but failed to import"
+                " -- likely built for a different Python (ABI mismatch);"
+                " rebuild for current Python",
+            )
         return None, CheckResult("renderdoc-module", False, "not found in search paths")
 
     version = getattr(module, "GetVersionString", lambda: "unknown")()

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc/commands/session.py

@@ -186,6 +186,14 @@ def _complete_capture_path(
     default=None,
     help="Daemon startup timeout in seconds.",
 )
+@click.option(
+    "--gpu",
+    "gpu",
+    default=None,
+    metavar="INDEX|NAME|DEVICEID",
+    help="Force the replay GPU by 0-based index, name substring, or device ID "
+    "(overrides auto-selection).",
+)
 def open_cmd(
     capture: str | None,
     preload: bool,
@@ -197,6 +205,7 @@ def open_cmd(
     connect: str | None,
     connect_token: str | None,
     timeout: float | None,
+    gpu: str | None,
 ) -> None:
     """Create local default session and start daemon skeleton."""
     # Handle --remote deprecation
@@ -242,6 +251,11 @@ def open_cmd(
     if connect is None and connect_token is not None:
         click.echo("warning: --token is ignored without --connect", err=True)
 
+    # --gpu configures the daemon's replay; an external daemon (--connect) is
+    # already running, so it cannot apply here.
+    if gpu is not None and connect is not None:
+        click.echo("warning: --gpu is ignored with --connect", err=True)
+
     # Dispatch: --connect
     if connect is not None:
         assert connect_token is not None
@@ -276,7 +290,9 @@ def open_cmd(
             click.echo(f"error: file not found: {capture}", err=True)
             raise SystemExit(1)
         try:
-            ok, result = listen_open_session(capture, listen, remote_url=proxy_url, timeout=timeout)
+            ok, result = listen_open_session(
+                capture, listen, remote_url=proxy_url, timeout=timeout, gpu=gpu
+            )
         except ValueError as exc:
             click.echo(f"error: {exc}", err=True)
             raise SystemExit(1) from None
@@ -300,7 +316,7 @@ def open_cmd(
     if proxy_url is None and not Path(capture).exists():
         click.echo(f"error: file not found: {capture}", err=True)
         raise SystemExit(1)
-    ok, message = open_session(capture, remote_url=proxy_url, timeout=timeout)
+    ok, message = open_session(capture, remote_url=proxy_url, timeout=timeout, gpu=gpu)
     if not ok:
         click.echo(message, err=True)
         raise SystemExit(1)

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc/daemon_server.py

@@ -141,6 +141,7 @@ class DaemonState:
     _debug_messages_cache: list[Any] | None = None
     remote: Any = None
     remote_url: str = ""
+    gpu_pref: str = ""
     is_remote: bool = False
     local_capture_path: str = ""
     local_capture_is_temp: bool = False
@@ -226,18 +227,49 @@ def _find_adapter_description(chunk: Any) -> AdapterMatch | None:
         return None
 
 
-def _match_capture_gpu(cap: Any, sd: Any = None, rd: Any = None) -> Any | None:
+def _resolve_gpu_pref(gpus: list[Any], pref: str) -> Any | None:
+    """Resolve a user ``--gpu`` preference against the available GPUs.
+
+    Accepts, in order: a 0-based index, a device ID (decimal or ``0x`` hex),
+    or a case-insensitive substring of the GPU name. Returns the matching
+    ``GPUDevice``, or ``None`` if nothing matches.
+    """
+    pref = pref.strip()
+    if not pref:
+        return None
+    if pref.isdigit() and int(pref) < len(gpus):
+        return gpus[int(pref)]
+    try:
+        want_id = int(pref, 0)
+    except ValueError:
+        want_id = None
+    if want_id is not None:
+        for g in gpus:
+            if g.deviceID == want_id:
+                return g
+    needle = pref.lower()
+    for g in gpus:
+        if needle in g.name.lower():
+            return g
+    return None
+
+
+def _match_capture_gpu(
+    cap: Any, sd: Any = None, rd: Any = None, pref: str | None = None
+) -> Any | None:
     """Pick the replay GPU that produced ``cap``.
 
-    Walks structured-data chunks to match the capture's Vulkan
-    ``vkEnumeratePhysicalDevices`` device name or the D3D12 adapter
-    description. Falls back to vendor priority (nVidia > AMD > Intel,
-    Software/WARP excluded) when no chunk-based match succeeds.
+    When *pref* is given (the user's ``--gpu``), it takes precedence over
+    auto-selection. Otherwise walks structured-data chunks to match the
+    capture's Vulkan ``vkEnumeratePhysicalDevices`` device name or the D3D12
+    adapter description, falling back to vendor priority (nVidia > AMD >
+    Intel, Software/WARP excluded) when no chunk-based match succeeds.
 
     Args:
         cap: An open renderdoc capture file.
         sd: Optional structured data from ``cap.GetStructuredData()``.
         rd: Optional renderdoc module, used for ``GPUVendor`` enum lookup.
+        pref: Optional user GPU preference (index, device ID, or name substring).
 
     Returns:
         The selected ``GPUDevice`` or ``None`` when no GPUs are available.
@@ -246,6 +278,16 @@ def _match_capture_gpu(cap: Any, sd: Any = None, rd: Any = None) -> Any | None:
         gpus = cap.GetAvailableGPUs()
         if not gpus:
             return None
+        if pref:
+            chosen = _resolve_gpu_pref(gpus, pref)
+            if chosen is not None:
+                _log.info("replay GPU (user --gpu=%r): %s", pref, chosen.name)
+                return chosen
+            _log.warning(
+                "--gpu=%r matched no available GPU; available=%r -- using auto-selection",
+                pref,
+                [(g.name, g.deviceID) for g in gpus],
+            )
         if len(gpus) == 1:
             return gpus[0]
 
@@ -363,7 +405,7 @@ def _load_replay(state: DaemonState) -> str | None:
         return "local replay not supported on this platform"
 
     opts = rd.ReplayOptions()
-    gpu = _match_capture_gpu(cap, cap.GetStructuredData(), rd)
+    gpu = _match_capture_gpu(cap, cap.GetStructuredData(), rd, state.gpu_pref or None)
     if gpu is not None:
         opts.forceGPUVendor = gpu.vendor
         opts.forceGPUDeviceID = gpu.deviceID
@@ -520,7 +562,9 @@ def _load_remote_replay(state: DaemonState, remote_url: str) -> str | None:
                 try:
                     open_result = tmp_cap.OpenFile(state.local_capture_path, "", None)
                     if open_result == rd.ResultCode.Succeeded:
-                        gpu = _match_capture_gpu(tmp_cap, tmp_cap.GetStructuredData(), rd)
+                        gpu = _match_capture_gpu(
+                            tmp_cap, tmp_cap.GetStructuredData(), rd, state.gpu_pref or None
+                        )
                         if gpu is not None:
                             remote_opts.forceGPUVendor = gpu.vendor
                             remote_opts.forceGPUDeviceID = gpu.deviceID
@@ -703,9 +747,12 @@ def main() -> None:  # pragma: no cover
     parser.add_argument("--idle-timeout", type=int, default=1800)
     parser.add_argument("--no-replay", action="store_true", help=argparse.SUPPRESS)
     parser.add_argument("--remote-url", default=None)
+    parser.add_argument("--gpu", default=None)
     args = parser.parse_args()
 
-    state = DaemonState(capture=args.capture, current_eid=0, token=args.token)
+    state = DaemonState(
+        capture=args.capture, current_eid=0, token=args.token, gpu_pref=args.gpu or ""
+    )
 
     if not args.no_replay:
         if args.remote_url:

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc/discover.py

@@ -56,6 +56,16 @@ def _is_arm_studio_dir(directory: str) -> bool:
     return any("arm-performance-studio" in p.lower() for p in parts)
 
 
+def _has_renderdoc_module(directory: str) -> bool:
+    """Return True if *directory* holds an importable renderdoc module artifact."""
+    d = Path(directory)
+    return (
+        (d / "renderdoc.py").is_file()
+        or bool(list(d.glob("renderdoc*.so")))
+        or bool(list(d.glob("renderdoc*.pyd")))
+    )
+
+
 def _preload_librenderdoc(directory: str) -> None:
     """Preload librenderdoc.so with RTLD_GLOBAL for ARM PS patched module.
 
@@ -174,6 +184,10 @@ def find_renderdoc() -> ModuleType | None:
             _diagnostic = outcome
         elif outcome.result == ProbeResult.TIMEOUT:
             _diagnostic = outcome
+        elif outcome.result == ProbeResult.IMPORT_FAILED and _has_renderdoc_module(path):
+            # A module file is present but won't load (e.g. built for another
+            # Python); keep it so the caller can tell this from "not found".
+            _diagnostic = outcome
 
     if crash_prone_candidates:
         _diagnostic = ProbeOutcome(

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc/services/session_service.py

@@ -46,6 +46,7 @@ def start_daemon(
     host: str = "127.0.0.1",
     idle_timeout: int = 1800,
     remote_url: str | None = None,
+    gpu: str | None = None,
 ) -> subprocess.Popen[str]:
     cmd = [
         sys.executable,
@@ -62,6 +63,8 @@ def start_daemon(
         "--idle-timeout",
         str(idle_timeout),
     ]
+    if gpu:
+        cmd += ["--gpu", gpu]
     if remote_url:
         cmd += ["--remote-url", remote_url]
     elif not _renderdoc_available():
@@ -136,6 +139,7 @@ def open_session(
     *,
     remote_url: str | None = None,
     timeout: float | None = None,
+    gpu: str | None = None,
 ) -> tuple[bool, str]:
     exists, err = _check_existing_session()
     if exists:
@@ -148,7 +152,7 @@ def open_session(
     for _attempt in range(max_attempts):
         port = pick_port()
         token = secrets.token_hex(16)
-        proc = start_daemon(str(capture), port, token, remote_url=remote_url)
+        proc = start_daemon(str(capture), port, token, remote_url=remote_url, gpu=gpu)
 
         ok, detail = wait_for_ping(host, port, token, timeout_s=resolved_timeout, proc=proc)
         if ok:
@@ -382,6 +386,7 @@ def listen_open_session(
     *,
     remote_url: str | None = None,
     timeout: float | None = None,
+    gpu: str | None = None,
 ) -> tuple[bool, dict[str, Any] | str]:
     """Open a session with the daemon listening on a specified address.
 
@@ -408,6 +413,7 @@ def listen_open_session(
         token,
         host=bind_host,
         remote_url=remote_url,
+        gpu=gpu,
     )
 
     ok, detail = wait_for_ping(

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdc-cli
-Version: 0.5.5
+Version: 0.5.6
 Summary: CLI for RenderDoc .rdc captures
 Author: Jim
 License-Expression: MIT

{rdc_cli-0.5.5 → rdc_cli-0.5.6}/src/rdc_cli.egg-info/SOURCES.txt

@@ -71,6 +71,9 @@ openspec/changes/2026-03-03-bugfix-p2-batch/test-plan.md
 openspec/changes/2026-03-04-w6-windows-bugfixes/proposal.md
 openspec/changes/2026-03-04-w6-windows-bugfixes/tasks.md
 openspec/changes/2026-03-04-w6-windows-bugfixes/test-plan.md
+openspec/changes/2026-06-04-open-gpu-override/proposal.md
+openspec/changes/2026-06-04-open-gpu-override/tasks.md
+openspec/changes/2026-06-04-open-gpu-override/test-plan.md
 openspec/changes/archive/2026-02-18-bootstrap-foundation/proposal.md
 openspec/changes/archive/2026-02-18-bootstrap-foundation/tasks.md
 openspec/changes/archive/2026-02-18-bootstrap-foundation/test-plan.md
@@ -372,6 +375,9 @@ openspec/changes/archive/2026-05-15-issue-224-vsin-mesh/specs/daemon/spec.md
 openspec/changes/archive/2026-05-17-fix-225-d3d12-chunk-name/proposal.md
 openspec/changes/archive/2026-05-17-fix-225-d3d12-chunk-name/tasks.md
 openspec/changes/archive/2026-05-17-fix-225-d3d12-chunk-name/test-plan.md
+openspec/changes/archive/2026-05-17-fix-aur-deploy-action-v413/proposal.md
+openspec/changes/archive/2026-05-17-fix-aur-deploy-action-v413/tasks.md
+openspec/changes/archive/2026-05-17-fix-aur-deploy-action-v413/test-plan.md
 openspec/specs/architecture/spec.md
 openspec/specs/ci/spec.md
 openspec/specs/daemon/spec.md