Repository reference

Project root

5 files▾

Overview

Start with the product brief and repository contract.

1▾

README.md
project root

Build and packaging

Native build graph and Python packaging entry points.

2▾

Repository policy

Ignore rules and licensing metadata for the whole project.

2▾

Python wrapper

6 files▾

Entry points

Package marker and the Python CLI command surface.

2▾

Configuration

Default values and runtime settings for the Python wrapper.

2▾

Output

Terminal printing and report shaping for Python-facing flows.

2▾

Native commands

8 files▾

Entry point

Top-level native executable dispatch.

1▾

main.cpp
src

Check command

Interface and implementation for inspection-only checks.

2▾

Doctor command

Interface and implementation for diagnosis and repair flows.

2▾

Planned commands

Reserved files for build, setup, and validate behaviors.

3▾

Native core

16 files▾

Reporting and process

Core report types and subprocess execution primitives.

3▾

Platform and hardware detection

Host, driver, GPU, and CUDA environment discovery.

8▾

Repair and build helpers

Configuration, repo patching, and builder orchestration.

5▾

Kernels and UI

9 files▾

Elementwise kernel

Simple elementwise CUDA sample and shared declarations.

2▾

Memory benchmark

Memory transfer benchmarking kernels and declarations.

2▾

Reduction kernel

Reduction sample kernels and matching headers.

2▾

UI layer

Terminal placeholders and native report rendering.

3▾

Automation and tests

11 files▾

Automation

Bootstrap helpers and Docker environments for local reproduction.

3▾

C++ tests

Native coverage for CUDA environment, driver, and GPU probes.

3▾

Python tests

CLI, configuration, and report-output verification in Python.

3▾

Vendored placeholders

Reserved directories for future third-party dependencies.

2▾

Setup command placeholder

Placeholderv0.0.0

src/commands/setup.cpp

The setup/bootstrap path is described in the README but not implemented in native code yet.

README.md bootstrap.py main.cpp

Reference

src/commands/setup.cpp exists in the repository, but it is currently an empty placeholder.

Placeholder file

This path reserves architecture and intent in the repo, but it does not contain executable logic yet.

Intended role

This file should eventually prepare mostly-empty machines for CUDA use before higher-level diagnosis and validation happen.

Treat this file as a roadmap marker rather than current implementation.
Search results should still surface it so users can understand what parts of the project are planned but not yet filled in.

Search terms

setup command
bootstrap path
prepare machine
install prerequisites

Previous

src/commands/build.cpp

Next

src/commands/validate.cpp

Related files

Project overview

README.md

Defines the product thesis, the command model, the success criteria, and the repository layout for cuda-doctor.

Automation

scripts/bootstrap.py

Reserved automation entrypoint for repo or machine bootstrap work.

Native entrypoint

src/main.cpp

Owns native argument validation, text and JSON rendering, exit codes, and the interactive handoff from `doctor` to `doctor auto`.