setup

name	setup
description	Set up Intel GPU unitrace profiling tool. Use this skill whenever the user mentions unitrace, Intel GPU tracing, pti-gpu tracing tool, GPU profiling with unitrace, or wants to build/install unitrace from source. Also trigger when the user asks about tracing Intel GPU workloads with unitrace, profiling SYCL/Level Zero/OpenCL applications on Intel GPUs using unitrace, or setting up pti-gpu tools. This skill handles checking if unitrace is already available, and if not, cloning and building it from source.
license	MIT
metadata	{"unitrace":"Intel PTI-GPU","oneAPI":"Intel oneAPI","XPU":"Intel GPU","LevelZero":"Intel Level Zero"}

Intel unitrace Setup

Set up unitrace from Intel PTI-GPU. Always check PATH first before building.

Instructions

Step 1: Check if unitrace is already available

which unitrace 2>/dev/null && unitrace --help > /dev/null 2>&1 && echo "UNITRACE_AVAILABLE" || echo "UNITRACE_NOT_FOUND"

• If found: Report the path. Use it directly unless the user explicitly asks to rebuild.
• If NOT found: Proceed to Step 2.

Step 2: Check prerequisites

which g++ 2>/dev/null || which icpx 2>/dev/null || echo "NO_CXX_COMPILER"
cmake --version 2>/dev/null || echo "NO_CMAKE"
echo "CMPLR_ROOT=${CMPLR_ROOT:-NOT_SET}"
python3 --version 2>/dev/null || echo "NO_PYTHON"

Required:

• CMake 3.22+
• C++17 compiler (g++ or icpx)
• Intel oneAPI (use the "source-oneapi" skill if not initialized)
• Python 3.9+

Step 3: Clone and build

Default location: $HOME/.local/src/pti-gpu.

mkdir -p "$HOME/.local/src"
cd "$HOME/.local/src"
git clone https://github.com/intel/pti-gpu.git
cd pti-gpu/tools/unitrace
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

If MPI is not available, add -DBUILD_WITH_MPI=0.

Build options:

Option	Default	Description
BUILD_WITH_MPI	1	MPI profiling
BUILD_WITH_ITT	1	oneCCL/oneDNN profiling
BUILD_WITH_XPTI	1	SYCL/UR profiling
BUILD_WITH_OPENCL	1	OpenCL profiling

Step 4: Add to PATH

export PATH="$HOME/.local/src/pti-gpu/tools/unitrace/build:$PATH"

Step 5: Verify

unitrace --help