Nsight Graphics Analyzer — Development skill for Claude Code

nsight-graphics-analyzer

**English** | [简体中文](./README.zh-CN.md)

Nsight Graphics Analyzer is a Windows-only skill and CLI wrapper for **NVIDIA Nsight Graphics 2026.1+**. It helps Claude Code, Codex, or a human at the terminal capture GPU frames, export Nsight GPU Trace data, and inspect the result through small JSON files instead of multi-hundred-MB TSV artifacts.

The Python code uses only the standard library. No `pip install` is required.

[](https://github.com/FrostyLeaves/nsight-graphics-analyzer/actions/workflows/ci.yml) [](LICENSE)  

Requirements

Requirement	Notes
Windows 10/11	Required. The wrapper uses Windows process and path APIs.
NVIDIA Nsight Graphics 2026.1+	Install separately from NVIDIA Developer.
Python 3.10+	Standard library only.
NVIDIA GPU and supported driver	Required for Nsight capture and replay workflows.

Run the environment check first:

python plugins\nsight-graphics-analyzer\skills\nsight-graphics-analyzer\scripts\nsight.py doctor

If `ngfx_install` is `null`, install Nsight Graphics before trying to capture.

Quick Start

Capture a short GPU Trace and generate the three compact JSON artifacts:

python plugins\nsight-graphics-analyzer\skills\nsight-graphics-analyzer\scripts\nsight.py gputrace-capture `
  --exe "C:\Path\To\YourApp.exe" --wd "C:\Path\To" `
  --start-after-ms 5000 --max-duration-ms 1000 `
  --architecture Ada --metric-set-name "Throughput Metrics" `
  --time-every-action `
  --out "C:\Path\To\Captures\sample.ngfx-gputrace"

The wrapper writes these files next to the trace:

| Artifact | Purpose |