libuipc

Build and test the libuipc project using XMake. Use when building with xmake, running xmake f / xmake build / xmake run commands, selecting release/releasedbg/debug modes, or running Catch2 tests produced by xmake.

Build and test the libuipc project using CMake. Use when building the project, running cmake configure/build commands, compiling with RelWithDebInfo, running Catch2 tests, or when the user asks how to build or test libuipc.

General simulation development best practices for correctness, stability, and debuggability. Use when implementing or modifying simulation systems, solvers, constraints, or GPU kernels, especially for index safety, NaN/Inf issues, and diagnostics.

Review a libuipc pull request end-to-end: checkout the PR, summarize changes, list files for the human reviewer, and perform a domain-aware AI review covering physics correctness, backend architecture, C++ style, GPU code, and Python bindings. Optionally post review comments via `gh`. Use when the user provides a PR number, asks to review a PR, or wants to inspect a libuipc GitHub PR.

Push a version tag and optionally create a GitHub release

Conventional commit message format and rules for this project

Create a well-formatted conventional commit

How to add or edit Cursor rules in our project

Documentation style guide and rules for creating documentation

Fix a GitHub issue with proper branch, testing, and PR workflow

Fix a pull request based on review feedback

Format C++ code using clang-format

Create a well-structured pull request with proper description

GPU optimization workflow using uipc.profile, uipc.profile.nsight, and Nsight Compute CLI. Use when profiling, optimizing, or benchmarking CUDA kernels.

Overview of the main directories and important files in the repository. Use this to understand the project layout and find where code lives.

Guide for setting up repository remotes when working with forks

Run C++ and Python tests