3 releases

0.2.2	Jan 25, 2026
0.2.1	Jan 1, 2026
0.2.0	Dec 16, 2025

#8 in #ptx

401 downloads per month
Used in apr-cli

MIT/Apache

205KB
4.5K SLoC

trueno-explain

PTX/SIMD/wgpu visualization and tracing CLI for Trueno.

Features

PTX Analysis: Register pressure, memory patterns, instruction counts
Bug Detection: Static analysis for common GPU bugs (PARITY-114, etc.)
TUI Mode: Interactive kernel exploration
SIMD/wgpu: Vectorization and shader analysis (coming soon)

Installation

cargo install trueno-explain

Usage

# Analyze a GEMM kernel
trueno-explain ptx -K gemm_tiled -m 1024 -n 1024

# Interactive TUI mode
trueno-explain tui -K gemm_tiled

# Hunt for PTX bugs
trueno-explain bugs -K q4k_gemm --strict --fail-on-bugs

# Compare kernels
trueno-explain compare -a gemm_naive -b gemm_tiled --json

Available Kernels

Name	Description
`vector_add`	Simple vector addition
`gemm_naive`	Naive matrix multiply
`gemm_tiled`	Tiled matrix multiply
`softmax`	Numerically stable softmax
`q4k_gemm`	Q4_K quantized matmul
`q5k_gemm`	Q5_K quantized matmul
`q6k_gemm`	Q6_K quantized matmul

Commands

Command	Description
`ptx`	Analyze PTX code generation
`tui`	Interactive TUI explorer
`bugs`	Hunt for PTX bugs
`compare`	Compare two kernels
`diff`	Compare against baseline (CI integration)
`simd`	Analyze SIMD vectorization
`wgpu`	Analyze WGSL shaders

License

MIT License - see LICENSE

Part of Trueno

This crate is part of Trueno.

Dependencies

~13–28MB
~409K SLoC