rdc-cli 0.3.2__tar.gz → 0.3.4__tar.gz

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/.github/workflows/ci.yml

@@ -55,6 +55,24 @@ jobs:
       - run: uv sync --extra dev
       - run: uv run --with pip-audit pip-audit
 
+  validate-aur:
+    name: Validate AUR PKGBUILD
+    runs-on: ubuntu-latest
+    container: archlinux:latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install makedepends from PKGBUILD
+        run: |
+          deps=$(sed -n '/^makedepends=(/,/)/p' aur/PKGBUILD \
+                 | grep -oP "'[^']+'" | tr -d "'" | tr '\n' ' ')
+          pacman -Syu --noconfirm base-devel $deps
+
+      - name: Build wheel (no-isolation, same as PKGBUILD)
+        run: python -m build --wheel --no-isolation
+        env:
+          SETUPTOOLS_SCM_PRETEND_VERSION: "0.0.0"
+
   typecheck:
     name: Type check (mypy)
     runs-on: ubuntu-latest
@@ -77,12 +95,13 @@ jobs:
         run: uv run mypy src
 
   test:
-    name: Test (py${{ matrix.python-version }})
-    runs-on: ubuntu-latest
+    name: Test (py${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         python-version: ["3.10", "3.12", "3.14"]
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

{rdc_cli-0.3.2/src/rdc_cli.egg-info → rdc_cli-0.3.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: rdc-cli
-Version: 0.3.2
-Summary: Unix-friendly CLI for RenderDoc .rdc captures
+Version: 0.3.4
+Summary: CLI for RenderDoc .rdc captures
 Author: Jim
 License-Expression: MIT
 Classifier: Programming Language :: Python :: 3
@@ -56,20 +56,41 @@ rdc diff before.rdc after.rdc --draws | grep '~'             # what changed betw
 rdc close
 ```
 
-## Why rdc-cli?
+## Install
 
-RenderDoc is excellent at capturing GPU frames and replaying them interactively. But its GUI doesn't compose — you can't pipe a draw call list into `sort`, diff two captures in CI, or let an AI agent inspect shader state.
+**PyPI — Linux** (recommended)
 
-rdc-cli bridges that gap:
+```bash
+pipx install rdc-cli                  # install the CLI
+# Build the renderdoc Python module (one-time, ~3 min, needs cmake + ninja)
+curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash
+rdc doctor                            # verify everything works
+```
 
-- **TSV by default** — every command outputs tab-separated text that pipes directly into Unix tools. Raw numbers, not human-friendly formatting (use `--table` for that).
-- **VFS path namespace** — GPU state is navigable like a filesystem: `/draws/142/shader/ps`, `/passes/GBuffer/draws`, `/resources/88`. Explore with `ls`, read with `cat`.
-- **Daemon architecture** — load the capture once, then query as many times as you want. No per-command startup cost.
-- **Built for CI** — `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` with `diff(1)`-compatible exit codes (0=pass, 1=fail, 2=error).
-- **AI-agent friendly** — structured output (`--json`, `--jsonl`), deterministic VFS paths, and a [Claude Code skill](https://bananasjim.github.io/rdc-cli/) for automated GPU frame analysis.
-- **Escape hatch** — `rdc script` runs arbitrary Python inside the daemon with full access to the renderdoc module, for anything the CLI doesn't cover yet.
+**PyPI — Windows** (experimental)
+
+```bash
+pipx install rdc-cli
+python scripts/build_renderdoc.py     # needs cmake + Visual Studio Build Tools
+rdc doctor
+```
+
+**AUR** (Arch Linux — builds renderdoc automatically, no extra setup)
+
+```bash
+yay -S rdc-cli        # stable: tracks tagged releases
+yay -S rdc-cli-git    # git: tracks latest master
+```
+
+**From source**
+
+```bash
+git clone https://github.com/BANANASJIM/rdc-cli.git
+cd rdc-cli
+pixi install && pixi run sync
+```
 
-## Quick examples
+## Quickstart
 
 **Explore a capture like a filesystem:**
 
@@ -118,30 +139,18 @@ rdc diff before.rdc after.rdc --draws             # per-draw changes
 rdc diff before.rdc after.rdc --framebuffer       # pixel-level image diff
 ```
 
-## Install
-
-**PyPI** (recommended)
-
-```bash
-pipx install rdc-cli
-# build renderdoc Python module (one-time, ~3 min, needs cmake/ninja/python3)
-curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash
-rdc doctor   # verify installation
-```
-
-**AUR** (Arch Linux — builds renderdoc Python module automatically)
+## Why rdc-cli?
 
-```bash
-yay -S rdc-cli-git
-```
+RenderDoc is excellent at capturing GPU frames and replaying them interactively. But its GUI doesn't compose — you can't pipe a draw call list into `sort`, diff two captures in CI, or let an AI agent inspect shader state.
 
-**From source**
+rdc-cli bridges that gap:
 
-```bash
-git clone https://github.com/BANANASJIM/rdc-cli.git
-cd rdc-cli
-pixi install && pixi run sync
-```
+- **TSV by default** — every command outputs tab-separated text that pipes directly into Unix tools. Raw numbers, not human-friendly formatting (use `--table` for that).
+- **VFS path namespace** — GPU state is navigable like a filesystem: `/draws/142/shader/ps`, `/passes/GBuffer/draws`, `/resources/88`. Explore with `ls`, read with `cat`.
+- **Daemon architecture** — load the capture once, then query as many times as you want. No per-command startup cost.
+- **Built for CI** — `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` with `diff(1)`-compatible exit codes (0=pass, 1=fail, 2=error).
+- **AI-agent friendly** — structured output (`--json`, `--jsonl`), deterministic VFS paths, and a [Claude Code skill](https://bananasjim.github.io/rdc-cli/) for automated GPU frame analysis.
+- **Escape hatch** — `rdc script` runs arbitrary Python inside the daemon with full access to the renderdoc module, for anything the CLI doesn't cover yet.
 
 ## Commands
 
@@ -160,6 +169,7 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | Assertions | `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` |
 | Diff | `diff` (with `--draws`, `--stats`, `--framebuffer`, `--pipeline`, etc.) |
 | VFS | `ls`, `cat`, `tree` |
+| Remote | `remote connect`, `remote list`, `remote capture` |
 | Utility | `doctor`, `completion`, `capture`, `count`, `script`, `install-skill` |
 
 All list commands output TSV. All commands support `--json`. Footer/summary goes to stderr — stdout is always clean data.

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/README.md

@@ -27,20 +27,41 @@ rdc diff before.rdc after.rdc --draws | grep '~'             # what changed betw
 rdc close
 ```
 
-## Why rdc-cli?
+## Install
 
-RenderDoc is excellent at capturing GPU frames and replaying them interactively. But its GUI doesn't compose — you can't pipe a draw call list into `sort`, diff two captures in CI, or let an AI agent inspect shader state.
+**PyPI — Linux** (recommended)
 
-rdc-cli bridges that gap:
+```bash
+pipx install rdc-cli                  # install the CLI
+# Build the renderdoc Python module (one-time, ~3 min, needs cmake + ninja)
+curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash
+rdc doctor                            # verify everything works
+```
 
-- **TSV by default** — every command outputs tab-separated text that pipes directly into Unix tools. Raw numbers, not human-friendly formatting (use `--table` for that).
-- **VFS path namespace** — GPU state is navigable like a filesystem: `/draws/142/shader/ps`, `/passes/GBuffer/draws`, `/resources/88`. Explore with `ls`, read with `cat`.
-- **Daemon architecture** — load the capture once, then query as many times as you want. No per-command startup cost.
-- **Built for CI** — `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` with `diff(1)`-compatible exit codes (0=pass, 1=fail, 2=error).
-- **AI-agent friendly** — structured output (`--json`, `--jsonl`), deterministic VFS paths, and a [Claude Code skill](https://bananasjim.github.io/rdc-cli/) for automated GPU frame analysis.
-- **Escape hatch** — `rdc script` runs arbitrary Python inside the daemon with full access to the renderdoc module, for anything the CLI doesn't cover yet.
+**PyPI — Windows** (experimental)
+
+```bash
+pipx install rdc-cli
+python scripts/build_renderdoc.py     # needs cmake + Visual Studio Build Tools
+rdc doctor
+```
+
+**AUR** (Arch Linux — builds renderdoc automatically, no extra setup)
+
+```bash
+yay -S rdc-cli        # stable: tracks tagged releases
+yay -S rdc-cli-git    # git: tracks latest master
+```
+
+**From source**
+
+```bash
+git clone https://github.com/BANANASJIM/rdc-cli.git
+cd rdc-cli
+pixi install && pixi run sync
+```
 
-## Quick examples
+## Quickstart
 
 **Explore a capture like a filesystem:**
 
@@ -89,30 +110,18 @@ rdc diff before.rdc after.rdc --draws             # per-draw changes
 rdc diff before.rdc after.rdc --framebuffer       # pixel-level image diff
 ```
 
-## Install
-
-**PyPI** (recommended)
-
-```bash
-pipx install rdc-cli
-# build renderdoc Python module (one-time, ~3 min, needs cmake/ninja/python3)
-curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash
-rdc doctor   # verify installation
-```
-
-**AUR** (Arch Linux — builds renderdoc Python module automatically)
+## Why rdc-cli?
 
-```bash
-yay -S rdc-cli-git
-```
+RenderDoc is excellent at capturing GPU frames and replaying them interactively. But its GUI doesn't compose — you can't pipe a draw call list into `sort`, diff two captures in CI, or let an AI agent inspect shader state.
 
-**From source**
+rdc-cli bridges that gap:
 
-```bash
-git clone https://github.com/BANANASJIM/rdc-cli.git
-cd rdc-cli
-pixi install && pixi run sync
-```
+- **TSV by default** — every command outputs tab-separated text that pipes directly into Unix tools. Raw numbers, not human-friendly formatting (use `--table` for that).
+- **VFS path namespace** — GPU state is navigable like a filesystem: `/draws/142/shader/ps`, `/passes/GBuffer/draws`, `/resources/88`. Explore with `ls`, read with `cat`.
+- **Daemon architecture** — load the capture once, then query as many times as you want. No per-command startup cost.
+- **Built for CI** — `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` with `diff(1)`-compatible exit codes (0=pass, 1=fail, 2=error).
+- **AI-agent friendly** — structured output (`--json`, `--jsonl`), deterministic VFS paths, and a [Claude Code skill](https://bananasjim.github.io/rdc-cli/) for automated GPU frame analysis.
+- **Escape hatch** — `rdc script` runs arbitrary Python inside the daemon with full access to the renderdoc module, for anything the CLI doesn't cover yet.
 
 ## Commands
 
@@ -131,6 +140,7 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | Assertions | `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` |
 | Diff | `diff` (with `--draws`, `--stats`, `--framebuffer`, `--pipeline`, etc.) |
 | VFS | `ls`, `cat`, `tree` |
+| Remote | `remote connect`, `remote list`, `remote capture` |
 | Utility | `doctor`, `completion`, `capture`, `count`, `script`, `install-skill` |
 
 All list commands output TSV. All commands support `--json`. Footer/summary goes to stderr — stdout is always clean data.

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/aur/PKGBUILD

@@ -20,6 +20,7 @@ makedepends=(
   'python-build'
   'python-installer'
   'python-setuptools'
+  'python-setuptools-scm'
   'python-wheel'
   'cmake'
   'ninja'

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/aur/stable/PKGBUILD

@@ -20,6 +20,7 @@ makedepends=(
   'python-build'
   'python-installer'
   'python-setuptools'
+  'python-setuptools-scm'
   'python-wheel'
   'cmake'
   'ninja'

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/docs-astro/package-lock.json

@@ -11,8 +11,7 @@
         "@astrojs/tailwind": "^6.0.2",
         "astro": "^5.7.10",
         "gsap": "^3.12.7",
-        "tailwindcss": "^3.4.17",
-        "typed.js": "^2.1.0"
+        "tailwindcss": "^3.4.17"
       },
       "devDependencies": {
         "@tailwindcss/typography": "^0.5.19",
@@ -5371,12 +5370,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/typed.js": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/typed.js/-/typed.js-2.1.0.tgz",
-      "integrity": "sha512-bDuXEf7YcaKN4g08NMTUM6G90XU25CK3bh6U0THC/Mod/QPKlEt9g/EjvbYB8x2Qwr2p6J6I3NrsoYaVnY6wsQ==",
-      "license": "MIT"
-    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/docs-astro/package.json

@@ -14,8 +14,7 @@
     "@astrojs/tailwind": "^6.0.2",
     "astro": "^5.7.10",
     "gsap": "^3.12.7",
-    "tailwindcss": "^3.4.17",
-    "typed.js": "^2.1.0"
+    "tailwindcss": "^3.4.17"
   },
   "devDependencies": {
     "@tailwindcss/typography": "^0.5.19",

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/docs-astro/src/components/Hero.astro

@@ -35,7 +35,7 @@ const base = import.meta.env.BASE_URL;
       Designed for <span class="text-gpu-accent font-medium">CI pipelines</span> and <span class="text-gpu-purple font-medium">AI agents</span>.
     </p>
 
-    <!-- Typed.js terminal -->
+    <!-- Terminal session replay -->
     <div class="max-w-2xl mx-auto mb-14">
       <div class="terminal-window glow-accent">
         <div class="terminal-header">
@@ -44,11 +44,8 @@ const base = import.meta.env.BASE_URL;
           <span class="terminal-dot bg-[#28c840]"></span>
           <span class="ml-auto text-[10px] text-gray-500 font-mono tracking-wider uppercase">rdc-cli</span>
         </div>
-        <div class="terminal-body text-left min-h-[3rem]">
-          <div class="flex items-start">
-            <span class="text-gpu-green mr-2 select-none font-bold">$</span>
-            <span id="typed-output" class="text-gray-200"></span>
-          </div>
+        <div id="replay-terminal" class="terminal-body text-left overflow-y-auto text-xs md:text-sm transition-[height] duration-300 ease-out" style="min-height: 2.5rem; max-height: 24rem;">
+          <div id="replay-lines"></div>
         </div>
       </div>
     </div>
@@ -83,27 +80,118 @@ const base = import.meta.env.BASE_URL;
 </section>
 
 <script>
-  import Typed from 'typed.js';
-
-  new Typed('#typed-output', {
-    strings: [
-      'rdc open capture.rdc',
-      'rdc draws --json | jq \'.[] | select(.flags == "Drawcall")\'',
-      'rdc pipeline 142 --section shader',
-      'rdc shader 142 ps --target "SPIR-V (RenderDoc)"',
-      'rdc resources --type texture --sort size',
-      'rdc texture 5 -o albedo.png',
-      'rdc search "main" --scope shaders',
-      'rdc ls /draws/142/pipeline/',
-      'rdc counters --list | head',
-      'rdc close',
-    ],
-    typeSpeed: 35,
-    backSpeed: 15,
-    backDelay: 2500,
-    startDelay: 500,
-    loop: true,
-    showCursor: true,
-    cursorChar: '\u2588',
-  });
+  import playlists from '../data/replay.json';
+
+  const container = document.getElementById('replay-lines')!;
+  const terminal = document.getElementById('replay-terminal')!;
+
+  const TYPE_SPEED = 20;
+  const OUTPUT_LINE_DELAY = 30;
+  const SCENE_PAUSE = 1400;
+  const RESTART_PAUSE = 2000;
+
+  let playlistIndex = 0;
+
+  function sleep(ms: number) { return new Promise(r => setTimeout(r, ms)); }
+
+  function scrollToBottom() {
+    terminal.scrollTop = terminal.scrollHeight;
+  }
+
+  function createPromptLine(): { el: HTMLDivElement; span: HTMLSpanElement } {
+    const el = document.createElement('div');
+    el.className = 'flex items-start';
+    el.innerHTML = '<span class="text-gpu-green mr-2 select-none font-bold shrink-0">$</span>';
+    const span = document.createElement('span');
+    span.className = 'text-gray-200';
+    el.appendChild(span);
+    const cursor = document.createElement('span');
+    cursor.className = 'replay-cursor';
+    cursor.textContent = '\u2588';
+    el.appendChild(cursor);
+    container.appendChild(el);
+    return { el, span };
+  }
+
+  async function typeCommand(text: string) {
+    const { el, span } = createPromptLine();
+    scrollToBottom();
+    for (const ch of text) {
+      span.textContent += ch;
+      scrollToBottom();
+      await sleep(TYPE_SPEED);
+    }
+    el.querySelector('.replay-cursor')?.remove();
+  }
+
+  function renderOutputLine(line: string): HTMLDivElement {
+    const div = document.createElement('div');
+    div.className = 'text-gray-400 pl-0 whitespace-pre';
+
+    // TSV header (all-caps tab-separated)
+    if (/^\t*[A-Z_]+(\t[A-Z_]+)+$/.test(line)) {
+      div.className = 'text-gray-500 pl-0 whitespace-pre';
+      div.textContent = line.replace(/\t/g, '  ');
+      return div;
+    }
+
+    // Key-value lines (like rdc info)
+    const kvMatch = line.match(/^(\w[\w\s]*?)\s{2,}(.+)$/);
+    if (kvMatch) {
+      const k = document.createElement('span');
+      k.className = 'text-gray-500';
+      k.textContent = kvMatch[1];
+      div.appendChild(k);
+      div.appendChild(document.createTextNode('  '));
+      const v = document.createElement('span');
+      v.className = 'text-gray-300';
+      v.textContent = kvMatch[2];
+      div.appendChild(v);
+      return div;
+    }
+
+    // TSV data rows
+    if (line.includes('\t')) {
+      div.textContent = line.replace(/\t/g, '  ');
+      div.className = 'text-gray-300 pl-0 whitespace-pre';
+      return div;
+    }
+
+    // JSON
+    if (/^\s*[{}\[\]"]/.test(line)) {
+      div.className = 'text-gray-400 pl-0 whitespace-pre';
+      div.textContent = line;
+      return div;
+    }
+
+    div.textContent = line;
+    return div;
+  }
+
+  async function showOutput(output: string) {
+    if (!output) return;
+    for (const line of output.split('\n')) {
+      container.appendChild(renderOutputLine(line));
+      scrollToBottom();
+      await sleep(OUTPUT_LINE_DELAY);
+    }
+  }
+
+  async function runReplay() {
+    while (true) {
+      const playlist = playlists[playlistIndex % playlists.length];
+      playlistIndex++;
+      container.innerHTML = '';
+
+      for (const scene of playlist) {
+        await typeCommand(scene.cmd);
+        await sleep(200);
+        await showOutput(scene.output);
+        await sleep(SCENE_PAUSE);
+      }
+      await sleep(RESTART_PAUSE);
+    }
+  }
+
+  runReplay();
 </script>

{rdc_cli-0.3.2 → rdc_cli-0.3.4}/docs-astro/src/components/Install.astro

@@ -18,12 +18,14 @@
           <span class="text-[10px] text-gray-500 tracking-wider">recommended</span>
         </div>
         <div class="group relative terminal-window">
-          <div class="px-5 py-4 font-mono text-sm text-gray-200">
-            <span class="text-gpu-green select-none font-bold">$ </span>pipx install rdc-cli
+          <div class="px-5 py-4 font-mono text-sm text-gray-200 space-y-1">
+            <div><span class="text-gpu-green select-none font-bold">$ </span>pipx install rdc-cli</div>
+            <div class="text-gray-500"># build renderdoc Python module (~3 min, one-time)</div>
+            <div><span class="text-gpu-green select-none font-bold">$ </span>curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash</div>
           </div>
           <button
             class="copy-btn absolute top-3 right-3 px-2.5 py-1 text-[10px] text-gray-500 bg-gpu-card rounded-md opacity-100 md:opacity-0 md:group-hover:opacity-100 transition-all duration-200 hover:text-gpu-accent hover:bg-gpu-accent/10 uppercase tracking-wider font-bold"
-            data-copy="pipx install rdc-cli"
+            data-copy="pipx install rdc-cli && curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash"
           >
             Copy
           </button>
@@ -33,15 +35,16 @@
       <div class="install-block opacity-0">
         <div class="flex items-center gap-2 mb-2">
           <span class="text-[10px] font-bold text-gpu-purple uppercase tracking-[0.2em]">AUR</span>
-          <span class="text-[10px] text-gray-500 tracking-wider">Arch Linux</span>
+          <span class="text-[10px] text-gray-500 tracking-wider">Arch Linux — includes renderdoc</span>
         </div>
         <div class="group relative terminal-window">
-          <div class="px-5 py-4 font-mono text-sm text-gray-200">
-            <span class="text-gpu-green select-none font-bold">$ </span>yay -S rdc-cli-git
+          <div class="px-5 py-4 font-mono text-sm text-gray-200 space-y-1">
+            <div><span class="text-gpu-green select-none font-bold">$ </span>yay -S rdc-cli<span class="text-gray-500">       # stable: tagged releases</span></div>
+            <div><span class="text-gpu-green select-none font-bold">$ </span>yay -S rdc-cli-git<span class="text-gray-500">   # git: latest master</span></div>
           </div>
           <button
             class="copy-btn absolute top-3 right-3 px-2.5 py-1 text-[10px] text-gray-500 bg-gpu-card rounded-md opacity-100 md:opacity-0 md:group-hover:opacity-100 transition-all duration-200 hover:text-gpu-accent hover:bg-gpu-accent/10 uppercase tracking-wider font-bold"
-            data-copy="yay -S rdc-cli-git"
+            data-copy="yay -S rdc-cli"
           >
             Copy
           </button>