Guide

Task-oriented documentation. Each page walks through one part of using stax, with real commands and real output. Read it front to back the first time, then jump to whatever you need.

1. Getting Started — install the daemons, verify the install
2. Recording a Run — launch a target or attach to a PID
3. Inspecting a Run — top, flame, threads, annotate
4. Run Lifecycle — status, list, wait, stop, and the one-active-run rule
5. The Web UI — the live flamegraph in a browser
6. Integrating Target Spans — report executor/GPU/runtime work with origins
7. Profiling GPU Work — apply target spans to Metal/GPU timestamp counters
8. Profiling JIT Code — make JIT'd functions show up by name
9. Troubleshooting — diagnostics, logs, and common errors

New here? Start with Getting Started.