
Cli Anything Renderdoc
- 361 installs
- 46.6k repo stars
- Updated August 3, 2026
- hkuds/cli-anything
cli-anything-renderdoc is a headless CLI skill that analyzes RenderDoc GPU frame captures for developers who need to inspect draw calls, textures, and capture metadata without opening the RenderDoc GUI.
About
cli-anything-renderdoc is version 0.1.0 of an agent-friendly CLI harness for RenderDoc graphics debugging, installable with pip install cli-anything-renderdoc. It operates on RenderDoc .rdc frame captures to inspect metadata, sections, thumbnails, and format conversions; traverse and filter the action tree of draw calls, clears, dispatches, and markers; and list, inspect, and export textures such as PNG. The skill depends on RenderDoc Python bindings plus click and prompt-toolkit. Developers reach for cli-anything-renderdoc when diagnosing rendering bugs in games or GPU-heavy desktop apps and need scriptable capture replay and extraction during automated or agent-led debug sessions.
- RenderDoc CLI orchestration via cli-anything
- GPU frame capture and replay for agents
- Graphics regression debugging support
- Useful for game and 3D render pipelines
- Structured debug artifact handoff to LLMs
Cli Anything Renderdoc by the numbers
- 361 all-time installs (skills.sh)
- +17 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #155 of 550 CLI & Terminal skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-renderdocAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 361 |
|---|---|
| repo stars | ★ 46.6k |
| Last updated | August 3, 2026 |
| Repository | hkuds/cli-anything ↗ |
How do you analyze RenderDoc GPU captures from CLI?
Let agents drive RenderDoc captures, replay GPU frames, and extract graphics debug data when diagnosing rendering bugs in games or GPU-heavy desktop apps.
Who is it for?
Graphics and game engineers who already capture .rdc frames in RenderDoc and want headless, agent-scriptable replay and texture extraction.
Skip if: Developers without RenderDoc installed or teams debugging CPU-only backends with no GPU capture workflow.
When should I use this skill?
A rendering regression or GPU bug needs automated inspection of RenderDoc captures, draw calls, or exported frame textures.
What you get
Capture metadata reports, filtered action-tree listings, exported PNG textures, and converted capture artifacts from .rdc files.
- action-tree listings
- exported PNG textures
- capture metadata summaries
By the numbers
- Ships as version 0.1.0
- Requires click>=8.0 and prompt-toolkit>=3.0
Files
RenderDoc CLI Skill
Headless command-line analysis of RenderDoc GPU frame captures (.rdc files).
Capabilities
- Capture inspection: metadata, sections, thumbnails, format conversion
- Action tree: list/search/filter draw calls, clears, dispatches, markers
- Texture operations: list, inspect, export (PNG/JPG/DDS/HDR/EXR), pixel picking
- Pipeline state: full shader/RT/viewport state at any event
- Shader analysis: export shader in human-readable form (HLSL/GLSL/disasm), constant buffer readback
- Resource inspection: buffer/texture enumeration, raw data reading
- Mesh data: vertex shader input/output decoding
- GPU counters: enumerate and fetch hardware performance counters
Command Groups
capture
cli-anything-renderdoc -c frame.rdc capture info # Metadata + sections
cli-anything-renderdoc -c frame.rdc capture thumb -o t.png # Extract thumbnail
cli-anything-renderdoc -c frame.rdc capture convert -o out.rdc --format rdcactions
cli-anything-renderdoc -c frame.rdc actions list # All actions
cli-anything-renderdoc -c frame.rdc actions list --draws-only # Draw calls only
cli-anything-renderdoc -c frame.rdc actions summary # Counts by type
cli-anything-renderdoc -c frame.rdc actions find "Shadow" # Search by name
cli-anything-renderdoc -c frame.rdc actions get 42 # Single actiontextures
cli-anything-renderdoc -c frame.rdc textures list
cli-anything-renderdoc -c frame.rdc textures get <id>
cli-anything-renderdoc -c frame.rdc textures save <id> -o out.png --format png
cli-anything-renderdoc -c frame.rdc textures save-outputs 42 -o ./renders/
cli-anything-renderdoc -c frame.rdc textures pick <id> 100 200pipeline
cli-anything-renderdoc -c frame.rdc pipeline state 42
# Export shader in human-readable form
# Text shaders (GLSL/HLSL) → saved directly
# Binary shaders (DXBC/SPIR-V) → embedded source (HLSL/GLSL) or disassembly
cli-anything-renderdoc -c frame.rdc pipeline shader-export 42 --stage Fragment
cli-anything-renderdoc -c frame.rdc pipeline shader-export 42 --stage Vertex -o ./shaders/
cli-anything-renderdoc -c frame.rdc pipeline cbuffer 42 --stage Vertex --index 0
# Compare pipeline state between two events
# Default output: same directory as the capture file ; use -o to override
cli-anything-renderdoc -c a.rdc pipeline diff 100 200 -b b.rdc
cli-anything-renderdoc -c frame.rdc pipeline diff 100 200 # same capture
cli-anything-renderdoc -c a.rdc pipeline diff 100 200 -b b.rdc -o result.json
cli-anything-renderdoc -c a.rdc pipeline diff 100 200 -b b.rdc --no-compactresources
cli-anything-renderdoc -c frame.rdc resources list
cli-anything-renderdoc -c frame.rdc resources buffers
cli-anything-renderdoc -c frame.rdc resources read-buffer <id> --format float32mesh
cli-anything-renderdoc -c frame.rdc mesh inputs 42 --max-vertices 10
cli-anything-renderdoc -c frame.rdc mesh outputs 42counters
cli-anything-renderdoc -c frame.rdc counters list
cli-anything-renderdoc -c frame.rdc counters fetch --ids 1,2,3Preview Bundles
RenderDoc preview support is for truthful capture inspection rather than live creative preview.
# List preview recipes
cli-anything-renderdoc -c frame.rdc --json preview recipes
# Capture a preview bundle for the active capture or a specific event
cli-anything-renderdoc -c frame.rdc --json preview capture --recipe quick --event-id 42
# Capture a diff preview bundle for two events or captures
cli-anything-renderdoc -c frame.rdc --json preview diff 100 200
cli-anything-renderdoc -c a.rdc --json preview diff 100 200 --capture-b b.rdc
# Return the latest existing bundle for the capture
cli-anything-renderdoc -c frame.rdc --json preview latest --recipe quickTypical preview bundle contents:
- capture thumbnail
- output-target images
pipeline_state.jsonaction_summary.json
Diff bundles additionally include:
- A/B thumbnails
- A/B output-target images
pipeline_diff.json
RenderDoc does not currently expose live preview sessions. Instead, each capture/diff bundle appends to a stable recipe-level trajectory.json.
Viewer commands:
cli-hub previews inspect /path/to/bundle
cli-hub previews html /path/to/bundle -o page.html
cli-hub previews open /path/to/bundleJSON Mode
All commands support --json for machine-readable output:
cli-anything-renderdoc -c frame.rdc --json actions summaryEnvironment Variables
| Variable | Description |
|---|---|
RENDERDOC_CAPTURE | Default capture file path |
PYTHONPATH | Must include RenderDoc path |
Agent Usage Notes
- Use `pipeline shader-export` to extract shaders — for binary shaders (DXBC/SPIR-V) it auto-exports embedded HLSL/GLSL source or falls back to disassembly; for text shaders (GLSL/HLSL) it saves the raw source directly
- Shader formats by capture API:
- D3D11 → DXBC binary, exported as embedded HLSL source (
.hlsl) or bytecode asm (.dxbc.asm) - OpenGL/GLES → GLSL source text (
.glsl), already human-readable - Vulkan → SPIR-V binary, exported as embedded GLSL source (
.glsl) or SPIR-V asm (.spv.asm) - Use `pipeline diff` to compare two events — it writes a JSON file and prints only the path; use
-bfor a second capture - Always specify
--jsonfor programmatic consumption - Use
actions summaryfirst to understand capture complexity - Use
actions list --draws-onlyto focus on actual rendering - Use
preview captureorpreview diffwhen the agent needs a portable,
honest inspection bundle rather than raw replay calls alone
- Read
_trajectory_pathfrom preview JSON if you need persistent capture/diff history - Use
cli-hub previews ...only to inspect/open already-generated bundles - Pipeline state requires an event ID from the action list
- Texture save supports: png, jpg, bmp, tga, hdr, exr, dds
- Buffer data can be decoded as hex, float32, uint32, or raw bytes
Related skills
How it compares
Pick this over manual GUI-only RenderDoc sessions when captures must be searched, exported, or summarized from scripts or coding agents.
FAQ
What file format does cli-anything-renderdoc analyze?
cli-anything-renderdoc analyzes RenderDoc GPU frame captures saved as .rdc files. The CLI inspects metadata, traverses the action tree, and exports textures without launching the RenderDoc desktop UI.
What do you need installed to use cli-anything-renderdoc?
cli-anything-renderdoc requires pip install cli-anything-renderdoc, RenderDoc Python bindings from a local RenderDoc installation, click 8.0 or newer, and prompt-toolkit 3.0 or newer for CLI and REPL features.