Skip to content

Add Cursor Cloud specific instructions to AGENTS.md#2071

Draft
kkraus14 wants to merge 4 commits into
mainfrom
cursor/env-setup-830c
Draft

Add Cursor Cloud specific instructions to AGENTS.md#2071
kkraus14 wants to merge 4 commits into
mainfrom
cursor/env-setup-830c

Conversation

@kkraus14
Copy link
Copy Markdown
Collaborator

@kkraus14 kkraus14 commented May 12, 2026

Description

Set up the Cursor Cloud Agent development environment for the cuda-python monorepo.

Changes

  1. AGENTS.md: Add ## Cursor Cloud specific instructions section documenting:

    • pixi as the primary environment manager (pulls CUDA headers from conda-forge)
    • Build commands for all three packages (cuda_pathfinder, cuda_bindings, cuda_core)
    • cu13 environment requirement for bindings/core (default env doesn't pin CUDA version)
    • Runtime vs build limitations (builds work without GPU; imports/tests for cuda_core need GPU)
    • Gotchas: lockfile v6 warnings, pre-commit first-run latency, default env build failures
  2. Cherry-pick from PR cuda.core: fix invalid python_version target in pixi.toml #2029: Fix invalid python_version target in cuda_core/pixi.toml

    • [package.target.'python_version < "3.11"'] is not valid pixi syntax
    • Moved backports.strenum to unconditional [package.run-dependencies]

Verified

Package Build Import Tests
cuda_pathfinder pixi install -e default from cuda.pathfinder import load_nvidia_dynamic_lib 975 passed, 4 skipped
cuda_bindings pixi install -e cu13 (26 .so modules) from cuda.bindings import driver, runtime, nvrtc Requires GPU
cuda_core pixi install -e cu13 (38 .so modules) Runtime import needs GPU drivers Requires GPU
Lint (ruff) pixi run ruff check . All checks passed N/A
pre-commit pre-commit run --all-files 21/21 hooks passed N/A

Checklist

  • New or existing tests cover these changes.
  • The documentation is up to date with these changes.
Open in Web Open in Cursor 

Co-authored-by: Keith Kraus <kkraus14@users.noreply.github.com>
@copy-pr-bot
Copy link
Copy Markdown
Contributor

copy-pr-bot Bot commented May 12, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

cursoragent and others added 2 commits May 12, 2026 16:13
Cherry-picked from PR #2029 (commit 18f5a02) to unblock pixi install.
Pixi's [package.target.<X>] only accepts platform identifiers; the
'python_version < "3.11"' selector caused parse failures.

Co-authored-by: Keith Kraus <kkraus14@users.noreply.github.com>
Pixi pulls CUDA Toolkit headers from conda-forge, enabling builds of
cuda_bindings and cuda_core without a local CUDA installation. Document
the cu13 environment requirement and runtime vs build limitations.

Co-authored-by: Keith Kraus <kkraus14@users.noreply.github.com>
@github-actions github-actions Bot added the cuda.core Everything related to the cuda.core module label May 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cuda.core Everything related to the cuda.core module

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants