# rdc-cli

Adopt this skill: https://proskills.md/skills/other/bananasjim-rdc-cli-src-rdc-skills

Page: https://proskills.md/skills/other/bananasjim-rdc-cli-src-rdc-skills
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: src/rdc/_skills/SKILL.md
size: 11647
sha: d707f1c750cdff4845b583601bfe6b47e1b9a5b1
upstream: https://github.com/bananasjim/rdc-cli/blob/master/src/rdc/_skills/SKILL.md

````text
---
name: rdc-cli
description: >
  Use this skill when working with RenderDoc capture files (.rdc), analyzing GPU frames,
  tracing shaders, inspecting draw calls, or running CI assertions against GPU captures.
  Trigger phrases: "open capture", "rdc file", ".rdc", "renderdoc", "shader debug",
  "pixel trace", "draw calls", "GPU frame", "assert pixel", "export render target".
---

# rdc-cli Skill

## Overview

rdc-cli is a Unix-friendly command-line interface for RenderDoc GPU captures. It provides a daemon-backed architecture using JSON-RPC over TCP, a virtual filesystem (VFS) path namespace for navigating capture internals, and composable commands designed for shell pipelines, scripting, and CI assertions.

Install: `pip install rdc-cli` (requires a local RenderDoc build with Python bindings).
Check setup: `rdc doctor`.

## Core Workflow

Follow this session lifecycle for any capture analysis task:

1. **Open** a capture:
   - Local: `rdc open path/to/capture.rdc`
   - Remote replay (Proxy): `rdc open capture.rdc --proxy host:port`
   - Split thin-client: `rdc open --connect host:port --token TOKEN`
   - Android device: `rdc open capture.rdc --android [--serial SERIAL]`
2. **Inspect** metadata: `rdc info`, `rdc stats`, `rdc events`
3. **Navigate** the VFS: `rdc ls /`, `rdc ls /textures`, `rdc cat /draws/0/pipeline/summary`
4. **Analyze** specifics: `rdc shaders`, `rdc pipeline`, `rdc resources`, `rdc bindings`
5. **Debug** shaders: `rdc debug pixel EID X Y`, `rdc debug vertex EID VTXID`, `rdc debug thread EID GX GY GZ`
6. **Export** data: `rdc texture ID -o out.png`, `rdc rt EID`, `rdc buffer ID -o buf.bin`, `rdc cbuffer EID --stage ps --binding 0`, `rdc log`
7. **Close** the session: `rdc close`

### Session Management

- Default session name: `default` (or value of `$RDC_SESSION`).
- Override per-command: `rdc --session myname open capture.rdc`.
- Check active session: `rdc status`.
- Navigate to a specific event: `rdc goto EID`.

## Output Formats

All list/table commands default to TSV (tab-separated values) with a header row, suitable for `cut`, `awk`, and `sort`.

| Flag | Format | Use Case |
|------|--------|----------|
| *(default)* | TSV with header | Human reading, shell pipelines |
| `--no-header` | TSV without header | Piping to `awk`/`cut` without stripping |
| `--json` | JSON array | Structured processing with `jq` |
| `--jsonl` | Newline-delimited JSON | Streaming processing, large datasets |
| `-q` / `--quiet` | Minimal (single column) | Extracting IDs for loops |

Example -- get all draw call EIDs as a plain list:

```bash
rdc draws -q
```

Example -- JSON pipeline with jq:

```bash
rdc events --json | jq '.[] | select(.type == "DrawIndexed")'
```

## Render Pass Analysis

### List passes (Phase 8 columns)

`rdc passes` outputs 6 columns: NAME, DRAWS, DISPATCHES, TRIANGLES, BEGIN_EID, END_EID.

```bash
rdc passes                          # TSV table
rdc passes --json                   # includes load_ops/store_ops per pass
rdc passes --deps --table           # per-pass READS/WRITES/LOAD/STORE
```

### Inspect a single pass

`rdc pass <name>` shows enriched attachments: resource name, format, dimensions, and load/store ops.

```bash
rdc pass GBuffer
rdc pass GBuffer --json
rdc pass 0                          # by 0-based index
```

### Detect dead render targets

`rdc unused-targets` finds render targets written but never consumed by visible output. Columns: ID, NAME, WRITTEN_BY, WAVE.

```bash
rdc unused-targets                  # TSV
rdc unused-targets --json           # structured
rdc unused-targets -q               # one resource ID per line (for scripting)
```

### Frame statistics

`rdc stats` outputs three sections: Per-Pass Breakdown, Top Draws by Triangle Count, and Largest Resources.

```bash
rdc stats                           # all three sections
rdc stats --json                    # includes largest_resources array
```

GL/GLES/D3D11 captures without native BeginPass/EndPass markers get synthetic pass inference automatically — no extra flags needed.

## Common Tasks

### Find all draw calls

```bash
rdc draws
rdc draws --pass "GBuffer" --json
```

### Trace a pixel

```bash
rdc debug pixel 1024 512 384            # EID first, then X Y
rdc debug pixel 1024 512 384 --json     # structured output
rdc debug pixel 1024 512 384 --trace    # full step-by-step trace
```

### Search shaders by name or source

```bash
rdc search "main"                  # regex search over shader disassembly
rdc search "Sample" --stage ps -C 2
rdc shaders --name "GBuffer*"
```

### Export render targets

```bash
rdc rt EID -o output.png
rdc rt EID --depth -o depth.png      # export the raw depth attachment
rdc texture ID -o tex.png            # export a texture by resource ID (PNG)
```

### Decode a constant buffer

```bash
rdc cbuffer EID --stage ps --binding 0           # decode to JSON
rdc cbuffer EID --stage vs --binding 0 --raw -o cbuffer.bin
```

### Browse VFS paths

```bash
rdc ls /
rdc ls /textures -l
rdc tree /draws/42/pipeline --depth 2     # pipeline state lives under /draws/<eid>/pipeline/
rdc cat /draws/42/pipeline/summary
rdc cat /events/42
```

### Inspect pipeline state at a draw call

```bash
rdc goto EID
rdc pipeline --json
rdc bindings --json
```

### Compare state before/after a pass

```bash
rdc goto 100 && rdc pipeline --json > before.json
rdc goto 200 && rdc pipeline --json > after.json
diff before.json after.json
```

## CI Assertions

rdc-cli provides assertion commands that exit non-zero on failure, designed for automated testing pipelines:

| Command | Purpose |
|---------|---------|
| `rdc assert-pixel EID X Y --expect "R G B A"` | Assert pixel RGBA (4 space-separated floats) at EID/coordinates |
| `rdc assert-clean` | Assert no validation errors in capture |
| `rdc assert-count <what> --expect N [--op CHOICE]` | Assert a capture metric (e.g. `draws`) satisfies a comparison |
| `rdc assert-state EID KEY-PATH --expect VALUE` | Assert pipeline state value at EID matches expected |
| `rdc assert-image EXPECTED ACTUAL [--threshold FLOAT]` | Compare two image files pixel-by-pixel |

Example CI script:

```bash
#!/bin/bash
set -e
rdc open test_capture.rdc
rdc assert-clean
rdc assert-count draws --expect 10 --op ge
rdc assert-pixel 1024 256 256 --expect "1.0 0.0 0.0 1.0"
rdc close
```

## Shader Edit-Replay

Modify and replay shaders without recompiling the application:

```bash
rdc shader-encodings                       # list available encodings
rdc shader EID ps --source > s.frag        # extract shader source
# ... edit s.frag ...
rdc shader-build s.frag --stage ps         # compile; prints the built shader ID
rdc shader-replace EID ps --with <ID>      # hot-swap built shader ID into capture
rdc shader-restore EID ps                  # revert single shader (STAGE required)
rdc shader-restore-all                     # revert all modifications
```

## Remote Capture Workflow

rdc-cli wraps `renderdoccmd remoteserver` to support PC-to-PC remote captures.

- `rdc serve [--port PORT] [--allow-ips CIDR] [--no-exec] [--daemon]` — launch remoteserver on the target machine
- `rdc remote connect <host:port>` — save remote connection state
- `rdc remote list` — enumerate capturable apps on the remote
- `rdc remote capture <app> -o frame.rdc [--args ...] [--frame N] [--keep-remote]` — inject, capture, and transfer back. `--keep-remote` skips the transfer and prints the remote path; replay it with `rdc open <path> --proxy host:port`. (The CLI's own `next:` hint currently still references the deprecated `--remote` alias for `--proxy`.)
- `rdc open frame.rdc --proxy host:port` — remote-backed replay (daemon local, GPU remote)

`remote_state.py` persists the last connected host so subsequent `rdc remote list` can omit `--url`.

## Split Mode (thin client)

Split mode decouples CLI and daemon — run the daemon where the GPU is and connect from a machine that doesn't need the renderdoc module. Useful when the analyst's laptop is macOS/Windows and the GPU is on a Linux server.

- Server side: `rdc open capture.rdc --listen [ADDR[:PORT]]`
  - Prints these four labeled lines to stdout (among other status output): `host: ADDR`, `port: PORT`, `token: TOKEN`, `connect with: rdc open --connect ADDR:PORT --token TOKEN`
- Client side: `rdc open --connect HOST:PORT --token TOKEN`

SSH tunnel tip (use the port from `--listen`, or `rdc serve`'s default `39920`): `ssh -L 39920:localhost:39920 user@server`, then connect to `localhost:39920`.

Every normal command (`rdc draws`, `rdc rt`, ...) works transparently in Split mode. Binary exports use `file_read` RPC with raw binary frames — no base64 overhead.

## Android Workflow

- Prerequisite: the RenderDoc APK must already be installed on the host via `rdc setup-renderdoc --android` (upstream) or `--android --arm` (ARM PS fork for Mali). `rdc android setup` does not push the APK itself.
- `rdc android setup [--serial SERIAL]` — starts remoteserver on the device via RenderDoc's Device Protocol API (`StartRemoteServer`), sets adb forward, saves remote state.
- `rdc android capture <activity> [--serial SERIAL] [--timeout N] [--port PORT] [-o out.rdc]` — GPU debug layers based capture (works around EMUI/Mali injection limitations).
- `rdc android stop [--serial SERIAL]` — stops the remoteserver and cleans state.
- For remote replay: `rdc open frame.rdc --android [--serial SERIAL]` — this is the only form that rewrites the saved `adb://SERIAL` to the forwarded `localhost:PORT`. Passing `--proxy adb://SERIAL` directly bypasses the rewrite and is known to crash the daemon (see `session.py:_resolve_android_url`).

Hardware matrix: Adreno is the happy path; Mali may need the ARM Performance Studio fork (see `rdc setup-renderdoc --android --arm`).

## Troubleshooting

Always run `rdc doctor` first. It reports status for renderdoc module, renderdoccmd, adb, Android APK, and platform-specific toolchains. Only the missing-renderdoc-module case emits a dedicated build-hint block; other checks surface inline hints in the detail column, so read each failing line rather than relying on a uniform next-step list.

Common failure categories (conceptual, not literal error strings — map from the text the tool actually emits):

- **network / connect failed** — remote host unreachable, firewall, wrong port. Verify `rdc serve` is running on the target.
- **version mismatch** — host and target RenderDoc versions differ. Re-run `rdc setup-renderdoc` or `rdc setup-renderdoc --android` to align.
- **inject failed / ident=0** — injection blocked (Android EMUI, macOS SIP, Windows privilege). Run `rdc doctor` and check the platform-specific detail.
- **OpenCapture unsupported** — local GPU can't replay the capture's API surface; switch to `--proxy` or `--android` remote replay.
- **duplicate Vulkan layer** — `rdc doctor` warns when more than one `VK_LAYER_RENDERDOC_Capture` Vulkan layer is registered (a system-installed RenderDoc plus the rdc-managed one create a split-brain). The loader then picks one non-deterministically and capture can silently time out; unregister the extra manifest so only one remains.
- **not loaded / no session** — forgot `rdc open`; use `rdc status` to inspect.

For long operations (large capture transfers, remote replay init), the CLI has limited progress feedback — this is a known UX gap, not a hang. Wait up to the `--timeout` value before concluding failure.

## Command Reference

For the complete list of all commands with their arguments, options, types, and defaults, see [references/commands-quick-ref.md](references/commands-quick-ref.md).
````

## File: src/rdc/_skills/references/commands-quick-ref.md
size: 31617
sha: 2c2f3ea33b77defdb45e701e8ea76a238cb98476
upstream: https://github.com/bananasjim/rdc-cli/blob/master/src/rdc/_skills/references/commands-quick-ref.md

```text
# rdc-cli Command Quick Reference

## `rdc android capture`

Capture a frame from an Android app using GPU debug layers.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `activity` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--serial` | Target device serial. | text |  |
| `-o, --output` | Local output path (default: <package>.rdc). | path |  |
| `--timeout` | Capture timeout in seconds. | float | 30.0 |
| `--port` | Target control port. | integer | 38920 |
| `--json` | Output as JSON. | flag |  |

## `rdc android setup`

Start RenderDoc remote server on an Android device.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--serial` | Target device serial. | text |  |
| `--json` | Output as JSON. | flag |  |

## `rdc android stop`

Stop RenderDoc remote server on an Android device.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--serial` | Target device serial. | text |  |
| `--json` | Output as JSON. | flag |  |

## `rdc assert-clean`

Assert capture log has no messages at or above given severity.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--min-severity` | Minimum severity threshold. | choice | HIGH |
| `--json` | JSON output. | flag |  |

## `rdc assert-count`

Assert a capture metric satisfies a numeric comparison.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `what` | choice | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--expect` | Expected count value. | integer |  |
| `--op` | Comparison operator. | choice | eq |
| `--pass` | Filter by render pass name. | text |  |
| `--json` | JSON output. | flag |  |

## `rdc assert-image`

Compare two images pixel-by-pixel.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `expected` | file | yes |
| `actual` | file | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--threshold` | Diff ratio threshold (%). | float | 0.0 |
| `--diff-output` | Write diff visualization PNG. | file |  |
| `--json` | JSON output. | flag |  |

## `rdc assert-pixel`

Assert pixel RGBA at (x, y) matches expected value within tolerance.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `x` | integer | yes |
| `y` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--expect` | Expected RGBA as 4 space-separated floats. | text |  |
| `--tolerance` | Per-channel tolerance. | float | 0.01 |
| `--target` | Render target index. | integer | 0 |
| `--json` | JSON output. | flag |  |

## `rdc assert-state`

Assert pipeline state value at EID matches expected.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `key_path` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--expect` | Expected value. | text |  |
| `--json` | JSON output. | flag |  |

## `rdc attach`

Attach to a running RenderDoc target by ident.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `ident` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--host` | Target host. | text | localhost |

## `rdc bindings`

Show bound resources per shader stage.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--binding` | Filter by binding index. | integer |  |
| `--set` | Filter by descriptor set index. | integer |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc buffer`

Export buffer raw data.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `id` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-o, --output` | Write to file | path |  |
| `--raw` | Force raw output even on TTY | flag |  |

## `rdc callstacks`

Resolve CPU callstack for an event.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--eid` | Event ID (defaults to current). | integer |  |
| `--json` | Output as JSON. | flag |  |

## `rdc capture`

Execute application and capture a frame.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-o, --output` | Output .rdc file path. | path |  |
| `--api` | Capture API name. | text |  |
| `--list-apis` | List capture APIs and exit. | flag |  |
| `--frame` | Queue capture at frame N. | integer |  |
| `--trigger` | Inject only; do not auto-capture. | flag |  |
| `--timeout` | Capture timeout in seconds. | float | 60.0 |
| `--wait-for-exit` | Wait for process to exit. | flag |  |
| `--keep-alive` | Keep target process running after capture. | flag |  |
| `--auto-open` | Open capture after success. | flag |  |
| `--api-validation` | Enable API validation. | flag |  |
| `--callstacks` | Capture callstacks. | flag |  |
| `--hook-children` | Hook child processes. | flag |  |
| `--ref-all-resources` | Reference all resources. | flag |  |
| `--soft-memory-limit` | Soft memory limit (MB). | integer |  |
| `--delay-for-debugger` | Debugger attach delay (s). | integer |  |
| `--json` | Output as JSON. | flag |  |

## `rdc capture-copy`

Copy a capture from the target to a local path.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `capture_id` | integer | yes |
| `dest` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--ident` | Target ident (default: most recent). | integer |  |
| `--host` | Target host. | text | localhost |
| `--timeout` | Timeout in seconds. | float | 30.0 |

## `rdc capture-list`

List captures from the attached target.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--ident` | Target ident (default: most recent). | integer |  |
| `--host` | Target host. | text | localhost |
| `--timeout` | Timeout in seconds. | float | 5.0 |
| `--json` | Output as JSON. | flag |  |

## `rdc capture-trigger`

Trigger a capture on the attached target.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--ident` | Target ident (default: most recent). | integer |  |
| `--host` | Target host. | text | localhost |
| `--num-frames` | Number of frames to capture. | integer | 1 |

## `rdc cat`

Output VFS leaf node content.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `path` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |
| `--raw` | Force raw output even on TTY | flag |  |
| `-o, --output` | Write binary output to file | path |  |

## `rdc cbuffer`

Decode a constant buffer to JSON or export its raw bytes.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--stage` | Shader stage (default: ps) | choice | ps |
| `--set` | Vulkan: descriptor set. D3D12: register space. | integer | 0 |
| `--binding` | Vulkan: binding. D3D12: shader register (bN). | integer | 0 |
| `--json` | JSON output (default) | flag |  |
| `--raw` | Export raw constant-buffer bytes | flag |  |
| `-o, --output` | Write raw bytes to file | path |  |

## `rdc close`

Close daemon-backed session.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--shutdown` | Send shutdown RPC to daemon. | flag |  |

## `rdc completion`

Generate shell completion script.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `shell` | choice | no |

## `rdc count`

Output a single integer count to stdout.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `what` | choice | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--pass` | Filter by render pass name. | text |  |

## `rdc counters`

Query GPU performance counters.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--list` | List available counters. | flag |  |
| `--eid` | Filter to specific event ID. | integer |  |
| `--name` | Filter counters by name substring. | text |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc debug pixel`

Debug pixel shader at (X, Y) for event EID.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `x` | integer | yes |
| `y` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--trace` | Full execution trace (TSV) | flag |  |
| `--dump-at` | Var snapshot at LINE | integer |  |
| `--sample` | MSAA sample index | integer |  |
| `--primitive` | Primitive ID override | integer |  |
| `--json` | JSON output | flag |  |
| `--no-header` | Suppress TSV header row | flag |  |

## `rdc debug thread`

Debug compute shader thread at workgroup (GX,GY,GZ) thread (TX,TY,TZ).

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `gx` | integer | yes |
| `gy` | integer | yes |
| `gz` | integer | yes |
| `tx` | integer | yes |
| `ty` | integer | yes |
| `tz` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--trace` | Full execution trace (TSV) | flag |  |
| `--dump-at` | Var snapshot at LINE | integer |  |
| `--json` | JSON output | flag |  |
| `--no-header` | Suppress TSV header row | flag |  |

## `rdc debug vertex`

Debug vertex shader for vertex VTX_ID at event EID.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `vtx_id` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--trace` | Full execution trace (TSV) | flag |  |
| `--dump-at` | Var snapshot at LINE | integer |  |
| `--instance` | Instance index (default 0) | integer | 0 |
| `--json` | JSON output | flag |  |
| `--no-header` | Suppress TSV header row | flag |  |

## `rdc descriptors`

Show the descriptors a draw actually used, resolved to resources.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--stage` | Filter by shader stage. | choice |  |
| `--type` | Filter by descriptor type (case-insensitive). | text |  |
| `--binding` | Filter by binding name or number. | text |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc diff`

Compare two RenderDoc captures side-by-side.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `capture_a` | file | yes |
| `capture_b` | file | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--draws` |  | flag |  |
| `--resources` |  | flag |  |
| `--passes` |  | flag |  |
| `--stats` |  | flag |  |
| `--framebuffer` |  | flag |  |
| `--pipeline` |  | text |  |
| `--json` |  | flag |  |
| `--format` |  | choice | tsv |
| `--shortstat` |  | flag |  |
| `--no-header` |  | flag |  |
| `--verbose` |  | flag |  |
| `--timeout` |  | float | 60.0 |
| `--target` | Color target index (default 0) | integer | 0 |
| `--threshold` | Max diff ratio %% to count as identical | float | 0.0 |
| `--eid` | Compare at specific EID (default: last draw) | integer |  |
| `--diff-output` | Write diff PNG here | path |  |

## `rdc doctor`

Run environment checks for rdc-cli.

## `rdc draw`

Show draw call detail.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |

## `rdc draws`

List draw calls.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--pass` | Filter by pass name | text |  |
| `--sort` | Sort field | text |  |
| `--limit` | Max rows | integer |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc event`

Show single API call detail.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |

## `rdc events`

List all events.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--type` | Filter by type | text |  |
| `--filter` | Filter by name glob | text |  |
| `--limit` | Max rows | integer |  |
| `--range` | EID range N:M | text |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc goto`

Update current event id via daemon.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |

## `rdc gpus`

List GPUs available at capture time.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output as JSON. | flag |  |

## `rdc info`

Show capture metadata.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |

## `rdc install-skill`

Install rdc-cli skill files to ~/.claude/skills/rdc-cli/.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--check` | Verify installed files are current. | flag |  |
| `--remove` | Remove installed skill files. | flag |  |

## `rdc log`

Show debug/validation messages from the capture.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--level` | Filter by severity. | choice |  |
| `--eid` | Filter by event ID. | integer |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc ls`

List VFS directory contents.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `path` | text | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-F, --classify` | Append type indicator (/ * @) | flag |  |
| `-l, --long` | Long format (TSV with metadata) | flag |  |
| `--json` | JSON output | flag |  |
| `--no-header` | Omit TSV header (with -l) | flag |  |
| `--jsonl` | JSONL output (with -l) | flag |  |
| `-q, --quiet` | Print name only (with -l) | flag |  |

## `rdc mesh`

Export post-transform mesh as OBJ.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--stage` | Mesh data stage (default: vs-out) | choice | vs-out |
| `-o, --output` | Write to file | path |  |
| `--json` | JSON output | flag |  |
| `--no-header` | Suppress OBJ header comment | flag |  |
| `--position-attribute` | VS-IN position input name/semantic | text |  |
| `--position-index` | VS-IN position input list index | integer |  |
| `--position-slot` | VS-IN position vertex buffer slot | integer |  |
| `--position-offset` | VS-IN position byte offset | integer |  |

## `rdc open`

Create local default session and start daemon skeleton.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `capture` | text | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--preload` | Preload shader cache after open. | flag |  |
| `--proxy` | Proxy host[:port] or adb://SERIAL for remote replay. | text |  |
| `--android` | Use saved Android device for remote replay. | flag |  |
| `--serial` | Android device serial (with --android). | text |  |
| `--remote` |  | text |  |
| `--listen` | Listen on [ADDR]:PORT. Use :0 for auto-port on all interfaces. | text |  |
| `--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`

Show detail for a single render pass by 0-based index or name.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `identifier` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output JSON. | flag |  |

## `rdc passes`

List render passes.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--deps` | Show pass dependency DAG. | flag |  |
| `--dot` | Graphviz DOT output (requires --deps). | flag |  |
| `--graph` | Human-readable graph (requires --deps). | flag |  |
| `--table` | Per-pass I/O table (requires --deps). | flag |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc pick-pixel`

Read pixel color at (X, Y) from the current render target.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `x` | integer | yes |
| `y` | integer | yes |
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--target` | Color target index (default 0) | integer | 0 |
| `--json` | JSON output | flag |  |

## `rdc pipeline`

Show pipeline summary for current or specified EID.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |
| `section` | text | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output JSON. | flag |  |

## `rdc pixel`

Query pixel history at (X, Y) for the current or specified event.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `x` | integer | yes |
| `y` | integer | yes |
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--target` | Color target index (default 0) | integer | 0 |
| `--sample` | MSAA sample index (default 0) | integer | 0 |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc remote capture`

Capture on a remote host and transfer to local.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `app` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-o, --output` | Local output path. | path |  |
| `--url` | Override saved remote (host:port). | text |  |
| `--args` | Arguments for remote app. | text |  |
| `--workdir` | Remote working directory. | text |  |
| `--frame` | Queue capture at frame N. | integer |  |
| `--timeout` | Capture timeout in seconds. | float | 60.0 |
| `--api-validation` | Enable API validation. | flag |  |
| `--callstacks` | Capture callstacks. | flag |  |
| `--hook-children` | Hook child processes. | flag |  |
| `--ref-all-resources` | Reference all resources. | flag |  |
| `--soft-memory-limit` | Soft memory limit (MB). | integer |  |
| `--keep-remote` | Skip transfer; print remote path for use with 'rdc open --remote'. | flag |  |
| `--json` | Output as JSON. | flag |  |

## `rdc remote connect`

Connect to a remote RenderDoc server.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `url` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output as JSON. | flag |  |

## `rdc remote disconnect`

Delete the saved remote server state (local only).

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output as JSON. | flag |  |

## `rdc remote list`

List capturable applications on a remote host.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--url` | Override saved remote (host:port). | text |  |
| `--json` | Output as JSON. | flag |  |

## `rdc remote setup`

Verify a remote server is reachable, handshake, and save state.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `url` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--timeout` | TCP probe timeout in seconds. | float | 10.0 |
| `--json` | Output as JSON. | flag |  |

## `rdc remote status`

Show the currently saved remote server state.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output as JSON. | flag |  |

## `rdc resource`

Show details of a specific resource.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `resid` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output JSON. | flag |  |

## `rdc resources`

List all resources.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--type` | Filter by resource type (exact, case-insensitive). | text |  |
| `--name` | Filter by name substring (case-insensitive). | text |  |
| `--sort` | Sort order. | choice | id |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc rt`

Export render target as PNG.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-o, --output` | Write to file | path |  |
| `--target` | Color target index (default 0); mutually exclusive with --depth | integer |  |
| `--depth` | Export the raw depth attachment texture (/draws/<eid>/targets/depth.png); distinct from --overlay depth, which renders RenderDoc's depth overlay visualization. Ignored when --overlay is set. | flag |  |
| `--raw` | Force raw output even on TTY | flag |  |
| `--overlay` | Render with debug overlay | choice |  |
| `--width` | Overlay render width | integer | 256 |
| `--height` | Overlay render height | integer | 256 |

## `rdc script`

Execute a Python script inside the daemon process.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `script_file` | file | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--arg` | Script argument. | text |  |
| `--json` | Raw JSON output. | flag |  |

## `rdc search`

Search shader disassembly text for PATTERN (regex).

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `pattern` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--stage` | Filter by stage (vs/ps/cs/...). | text |  |
| `--limit` | Max results. | integer | 200 |
| `-C, --context` | Context lines. | integer | 0 |
| `--case-sensitive` | Case-sensitive search. | flag |  |
| `--json` | JSON output. | flag |  |

## `rdc section`

Extract or write named section contents.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `name` | text | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output as JSON. | flag |  |
| `--write` | Write file contents as this section (use '-' for stdin). | path |  |

## `rdc sections`

List all embedded sections.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | Output as JSON. | flag |  |

## `rdc serve`

Launch renderdoccmd remoteserver for remote replay.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--port` | Listen port. | integer | 39920 |
| `--host` | Bind address. | text | 0.0.0.0 |
| `--allow-ips` | Comma-separated CIDR whitelist written to remoteserver.conf. | text |  |
| `--no-exec` | Add 'noexec' to config (replay-only). | flag |  |
| `--daemon` | Detach after printing PID. | flag |  |

## `rdc setup-renderdoc`

Build and install the renderdoc Python module from source.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `install_dir` | text | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--build-dir` | Build cache directory. | text |  |
| `--version` | RenderDoc tag to build. | text |  |
| `--jobs` | Parallel build jobs. | integer |  |
| `--android` | Download Android APKs. | flag |  |
| `--arm` | Download ARM Performance Studio (Mali). | flag |  |
| `--arm-studio` | ARM Performance Studio local install path. | directory |  |

## `rdc shader`

Show shader metadata for a stage at EID.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `first` | text | no |
| `second` | text | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--reflect` | Include reflection data (inputs/outputs/cbuffers). | flag |  |
| `--constants` | Include constant buffer values. | flag |  |
| `--source` | Include debug source code. | flag |  |
| `--target` | Disassembly target format (e.g., 'dxil', 'spirv', 'glsl'). | text |  |
| `--targets` | List available disassembly targets. | flag |  |
| `-o, --output` | Output file path. | path |  |
| `--all` | Get all shader data for all stages. | flag |  |
| `--json` | Output JSON. | flag |  |

## `rdc shader-build`

Build a shader from source file.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `source_file` | file | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--stage` | Shader stage | choice |  |
| `--entry` | Entry point name | text | main |
| `--encoding` | Encoding name (default: GLSL) | text | GLSL |
| `--json` | JSON output | flag |  |
| `-q, --quiet` | Print only shader_id | flag |  |

## `rdc shader-encodings`

List available shader encodings for this capture.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |

## `rdc shader-map`

Output EID-to-shader mapping as TSV.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc shader-replace`

Replace shader at EID/STAGE with a built shader.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `stage` | choice | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--with` | Built shader ID from shader-build | integer |  |
| `--json` | JSON output | flag |  |

## `rdc shader-restore`

Restore original shader at EID/STAGE.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |
| `stage` | choice | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |

## `rdc shader-restore-all`

Restore all replaced shaders and free built resources.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |

## `rdc shaders`

List unique shaders in capture.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--stage` | Filter by shader stage. | choice |  |
| `--sort` | Sort order. | choice | name |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc snapshot`

Export a complete rendering state snapshot for a draw event.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `eid` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-o, --output` | Output directory | path |  |
| `--json` | JSON output | flag |  |

## `rdc stats`

Show per-pass breakdown, top draws, largest resources.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |

## `rdc status`

Show current daemon-backed session status.

## `rdc tex-stats`

Show texture min/max statistics and optional histogram.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `resource_id` | integer | yes |
| `eid` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--mip` | Mip level (default 0) | integer | 0 |
| `--slice` | Array slice (default 0) | integer | 0 |
| `--histogram` | Show 256-bucket histogram | flag |  |
| `--json` | JSON output | flag |  |

## `rdc texture`

Export texture as PNG.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `id` | integer | yes |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `-o, --output` | Write to file | path |  |
| `--mip` | Mip level (default 0) | integer | 0 |
| `--slice` | Texture array or 3D depth slice (default 0) | integer range | 0 |
| `--raw` | Force raw output even on TTY | flag |  |

## `rdc thumbnail`

Export capture thumbnail.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--maxsize` | Max thumbnail dimension. | integer | 0 |
| `-o, --output` | Write image to file. | path |  |
| `--json` | Output as JSON. | flag |  |

## `rdc tree`

Display VFS subtree structure.

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `path` | text | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--depth` |  | integer range | 2 |
| `--json` | JSON output | flag |  |

## `rdc unused-targets`

Detect render targets produced but never consumed by visible output.

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--json` | JSON output | flag |  |
| `-q, --quiet` | One resource ID per line | flag |  |
| `--no-header` | Omit TSV header | flag |  |

## `rdc usage`

Show resource usage (which events read/write a resource).

**Arguments:**

| Name | Type | Required |
|------|------|----------|
| `resource_id` | integer | no |

**Options:**

| Flag | Help | Type | Default |
|------|------|------|---------|
| `--all` | Show all resources usage matrix. | flag |  |
| `--type` | Filter by resource type. | text |  |
| `--usage` | Filter by usage type. | text |  |
| `--no-header` | Omit TSV header | flag |  |
| `--json` | JSON output | flag |  |
| `--jsonl` | JSONL output | flag |  |
| `-q, --quiet` | Print primary key column only | flag |  |
```

## File: src/rdc/_skills/__init__.py
size: 0
sha: e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
upstream: https://github.com/bananasjim/rdc-cli/blob/master/src/rdc/_skills/__init__.py

```text

```

## File: README.md
upstream: https://github.com/bananasjim/rdc-cli/blob/master/README.md

````text
```
 _____  _____   _____
|  __ \|  __ \ / ____|
| |__) | |  | | |
|  _  /| |  | | |
| | \ \| |__| | |____
|_|  \_\_____/ \_____|  cli
```

[![PyPI](https://img.shields.io/pypi/v/rdc-cli)](https://pypi.org/project/rdc-cli/)
[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/rdc-cli/)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Commands](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/commands.json)](https://bananasjim.github.io/rdc-cli/)
[![Tests](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/tests.json)](https://bananasjim.github.io/rdc-cli/)
[![Coverage](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/coverage.json)](https://bananasjim.github.io/rdc-cli/)
[![Discord](https://img.shields.io/discord/1485003415687008296?logo=discord&label=Discord)](https://discord.gg/h3zwUadp4k)

**Turn RenderDoc captures into Unix text streams.** rdc-cli does not replace RenderDoc — it makes `.rdc` file contents accessible to `grep`, `awk`, `sort`, `diff`, `jq`, and AI agents.

**[Full documentation →](https://bananasjim.github.io/rdc-cli/)**

```bash
rdc open scene.rdc
rdc draws | grep Shadow | sort -t$'\t' -k3 -rn | head -5   # top 5 shadow draws by tri count
rdc shader 142 ps | grep shadowMap                           # find shadow sampling in PS
rdc cat /draws/142/shader/ps/constants                       # inspect bound constants
rdc diff before.rdc after.rdc --draws | grep '~'             # what changed between two frames?
rdc close
```

## Install

Requires Python 3.11 or newer. Starting with 0.7.0, rdc-cli requires Pillow 13
for its security fixes. Python 3.10 users must upgrade Python; rebuild the
RenderDoc Python module when changing Python minor versions.

**PyPI — Linux** (recommended)

```bash
uv tool install rdc-cli               # or: pipx install rdc-cli
rdc setup-renderdoc                   # build renderdoc Python module from source
rdc doctor                            # verify everything works
```

**PyPI — Windows** (requires git, uv, Visual Studio Build Tools)

```bash
uv tool install rdc-cli               # or: pipx install rdc-cli
rdc setup-renderdoc                   # build renderdoc Python module from source
rdc doctor                            # verify everything works
```

**PyPI — macOS** (Split client only)

```bash
uv tool install rdc-cli               # or: pipx install rdc-cli
rdc doctor
```

**AUR** (Arch Linux — builds renderdoc automatically, no extra setup)

```bash
yay -S rdc-cli-git    # recommended: tracks latest master
# or
yay -S rdc-cli        # stable: tracks tagged releases
```

**From source**

```bash
git clone https://github.com/BANANASJIM/rdc-cli.git
cd rdc-cli
pixi install && pixi run sync
pixi run install                      # editable install + shell completions
pixi run setup-renderdoc              # build renderdoc (pixi installs toolchain on macOS)
```

### Platform Support Matrix

| Platform | Local capture/replay | Split client | Remote capture |
|----------|----------------------|--------------|----------------|
| Linux | ✅ | ✅ | ✅ |
| macOS | ❌ (not supported yet) | ✅ (recommended) | — |
| Windows | ✅ | ✅ | ✅ |
| Android | — | — | ✅ capture + remote replay |

### RenderDoc bootstrap

After installing rdc-cli, build the renderdoc Python module:

```bash
rdc setup-renderdoc
```

If building from source, use the pixi wrapper instead: `pixi run setup-renderdoc`

## Quickstart

**Explore a capture like a filesystem:**

```bash
rdc ls /                              # top-level: draws, passes, resources, shaders, ...
rdc ls /draws/142                     # what's inside this draw call?
rdc cat /draws/142/pipeline/blend      # color blend state
rdc tree /passes --depth 2            # pass structure at a glance
```

**Shader debugging — no GUI needed:**

```bash
rdc shader 142 ps                     # pixel shader disassembly
rdc shader 142 ps --constants         # current constant buffer values
rdc debug pixel 142 400 300 --trace   # step-by-step PS execution trace
rdc search "shadowMap"                # grep across all shaders in the frame
```

**Export and scripting:**

```bash
rdc texture 5 -o albedo.png           # export a texture
rdc rt 142 -o render.png              # export render target
rdc rt 142 --depth -o depth.png       # export raw depth attachment
rdc buffer 88 -o verts.bin            # export raw buffer
rdc cbuffer 142 --stage ps --binding 0  # decode a constant buffer to JSON
rdc snapshot 142 -o ./snap/           # pipeline + shaders + render targets
rdc draws --json | jq '.[] | select(.triangles > 10000)'  # filter with jq
```

**CI assertions:**

```bash
rdc open frame.rdc
rdc assert-pixel 142 400 300 --expect "0.5 0.0 0.0 1.0" --tolerance 0.01
rdc assert-state 142 topology --expect TriangleList
rdc assert-image golden.png actual.png --threshold 0.001
rdc assert-clean --min-severity HIGH
rdc close
```

**Two-frame diff:**

```bash
rdc diff before.rdc after.rdc --shortstat        # summary: draws ±N, resources ±N
rdc diff before.rdc after.rdc --draws             # per-draw changes
rdc diff before.rdc after.rdc --framebuffer       # pixel-level image diff
```

**Remote replay and Split mode**

rdc-cli supports three deployment modes:

| Mode | Daemon runs on | GPU access | Client needs renderdoc? |
|------|---------------|------------|------------------------|
| **Local** | client | local GPU | yes |
| **Proxy** (`--proxy`) | client | remote `renderdoccmd` server | yes |
| **Split** (`--listen`/`--connect`) | server | server-local GPU | **no** |

```bash
# Multi-GPU host: force the replay GPU (0-based index, name, or device ID)
rdc open frame.rdc --gpu 1

# Proxy: local daemon, remote GPU (needs renderdoccmd on remote)
rdc open frame.rdc --proxy gpu-server:39920

# Split server: bind to a specific LAN interface
rdc open frame.rdc --listen 192.168.1.10:54321

# Split client: connect from any machine (no renderdoc needed)
rdc open --connect replay-host:54321 --token TOKEN
rdc draws                          # all commands work transparently
rdc close
```

Split mode is recommended for cross-platform use. All commands work transparently regardless of mode.

**Android capture and remote replay**

```bash
rdc setup-renderdoc --android            # download RenderDoc APKs for Android
rdc android setup                        # start remote server on connected device
rdc android capture com.app/.MainActivity -o frame.rdc   # capture via GPU debug layers

# Remote replay on the device GPU
rdc open frame.rdc --android             # auto-resolves device from saved state
rdc draws                                # all commands work transparently
rdc pick-pixel 540 1170 --json           # pixel queries work in remote mode
rdc close

rdc android stop                         # stop remote server
```

Android capture uses GPU debug layers (Android 10+). Remote replay uploads the capture back to the device for replay on the original GPU. Tested on Adreno and Mali (EMUI) devices. For Mali GPUs, ARM Performance Studio is recommended:

```bash
rdc setup-renderdoc --android --arm-studio /path/to/arm-performance-studio
```

## Why rdc-cli?

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.

rdc-cli bridges that gap:

- **TSV by default** — every command outputs tab-separated text that pipes directly into Unix tools. Raw numbers, not human-friendly formatting.
- **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-sta
````
