Debug Kernel

Debug compilation or runtime errors in LLK kernels. Infers architecture and kernel type from path.

tenstorrent Updated 125 repo stars

File contents

/debug-kernel — Debug an LLK Kernel

Usage

/debug-kernel tt_llk_blackhole/llk_lib/llk_pack_untilize.h
/debug-kernel tt_llk_quasar/common/inc/sfpu/ckernel_sfpu_gelu.h
/debug-kernel  (no args — will ask for the kernel path or check recent test output)

What to Do

  1. Parse the kernel path from the user's arguments. If not provided, check recent test output or ask.
  2. Infer the kernel type from the path:
    • common/inc/sfpu/ → sfpu
    • llk_lib/llk_math_ → math
    • llk_lib/llk_pack_ → pack
    • llk_lib/llk_unpack_ → unpack
  3. Infer the architecture from the path:
    • tt_llk_wormhole_b0/ → wormhole
    • tt_llk_blackhole/ → blackhole
    • tt_llk_quasar/ → quasar
  4. Spawn the llk-debugger agent:
Agent tool:
  subagent_type: "llk-debugger"
  description: "Debug {kernel_name}"
  prompt: |
    Kernel path: {kernel_path}
    Kernel type: {kernel_type}
    Architecture: {architecture}
    Error context: {any error output the user provided, or "check logs"}
  1. Report the agent's results to the user
  2. If the fix involves code changes, show the diff and explain the fix

tenstorrent/tt-metal commit 4a75f6db66

Frequently asked questions

npx get-skill add tenstorrent/debug-kernel