penspanic/webgpu-metal-debug-kit

README preview

# webgpu-metal-debug-kit

[![Agent Skill](https://img.shields.io/badge/agent--skill-v2.0-blue)](https://agentskills.io)
[![Platform](https://img.shields.io/badge/platform-macOS-lightgrey)]()
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

A toolkit for debugging Chrome WebGPU applications on macOS with AI coding assistants. Combines **Chrome DevTools MCP** for browser-level debugging with **Xcode `xctrace`** for Metal driver-level profiling.

## Why

WebGPU debugging is hard:
- No `printf` in shaders
- GPU timing doesn't show up in JS profilers
- When something renders wrong, you can't tell which stage broke
- Some bottlenecks are invisible from the browser (Dawn/Metal translation overhead)

This kit gives your AI assistant direct access to browser state (`evaluate_script`) and GPU driver traces (`xctrace`).

## Install

View full repository on GitHub →