# msvc-kit
[](https://crates.io/crates/msvc-kit)
[](https://crates.io/crates/msvc-kit)
[](https://github.com/loonghao/msvc-kit/releases)
[](https://opensource.org/licenses/MIT)
[](https://github.com/loonghao/msvc-kit/actions/workflows/ci.yml)
[](https://codecov.io/gh/loonghao/msvc-kit)
[](https://docs.rs/msvc-kit)
---
A portable MSVC Build Tools installer and manager for Rust/Windows.
### TL;DR
```bash
# Install the CLI
cargo install msvc-kit
# Download latest MSVC + Windows SDK into default data dir
msvc-kit download
# Apply environment to current shell (PowerShell)
### Features
- **Download MSVC compiler** from Microsoft servers
- **Download Windows SDK** to a chosen directory
- **Auto environment setup** for immediate use (cc-rs compatible)
- **Version management** for host/target architectures (x64, x86, arm64, arm)
- **Library API** for programmatic usage
- **Resumable downloads** with redb-based index for fast skip
- **Manifest caching** with ETag/Last-Modified conditional requests
- **TLS backend** uses `native-tls` (Windows schannel) to avoid `rustls`/`awslc-sys` build issues
- **Multi-format extraction** (VSIX, MSI, CAB)
- **Hash verification** with SHA256
### Installation
- **Via Winget (Recommended)**
```powershell
winget install loonghao.msvc-kit
```
- **Via PowerShell Script**
```powershell
irm https://github.com/loonghao/msvc-kit/releases/latest/download/install.ps1 | iex
```
- **From crates.io**
```bash
cargo install msvc-kit
```
- **Pre-built Binaries**
```powershell
# Download and extract to a directory in your PATH
Invoke-WebRequest -Uri "https://github.com/loonghao/msvc-kit/releases/latest/download/msvc-kit-x86_64-pc-windows-msvc.zip" -OutFile msvc-kit.zip
Expand-Archive msvc-kit.zip -DestinationPath $env:USERPROFILE\.cargo\bin -Force
```
- **From source**
```bash
git clone https://github.com/loonghao/msvc-kit.git
cd msvc-kit
cargo install --path .
```
### Release bundles
- On every tagged release (or release-please cut), CI builds and uploads `msvc-bundle-<msvc>-<sdk>-<arch>.zip` for `x64`, `x86`, and `arm64` directly to the GitHub Release.
- Bundles are created via `msvc-kit bundle --accept-license`; by downloading you agree to the Microsoft Visual Studio License Terms.
### Quick Start (CLI)
#### Download
```bash
# Latest versions
msvc-kit download
# Specify versions / dirs / arch
# MSVC version can be short (14.44) or full (14.44.34823)
msvc-kit download \
--msvc-version 14.44 \
--sdk-version 10.0.26100.0 \
--target C:\msvc-kit \
--arch x64 \
--host-arch x64
# Download only MSVC (skip SDK)
msvc-kit download --no-sdk
# Download only SDK (skip MSVC)
msvc-kit download --no-msvc
# Control parallel downloads (default: 4)
msvc-kit download --parallel-downloads 8
# Skip hash verification
msvc-kit download --no-verify
```
> **Note:** MSVC version can be specified as short format (e.g., `14.44`) which auto-resolves to the latest build, or full format (e.g., `14.44.34823`) for a specific build.
**Version Compatibility Quick Reference:**
| Latest (recommended) | `14.44` | `10.0.26100.0` | `msvc-kit download` |
| Windows 11 development | `14.42`+ | `10.0.22621.0`+ | `msvc-kit download --sdk-version 10.0.22621.0` |
| Maximum Win10 compat | `14.40` | `10.0.19041.0` | `msvc-kit download --msvc-version 14.40 --sdk-version 10.0.19041.0` |
See [Version Compatibility Guide](docs/guide/cli-download.md#version-compatibility-guide) for detailed information.
#### Setup Environment
```bash
# Generate script for current shell
# Or for CMD
msvc-kit setup --script --shell cmd > setup.bat && setup.bat
# Portable script (rewrites install root to %~dp0runtime)
msvc-kit setup --script --shell cmd --portable-root "%~dp0runtime" > setup.bat
# Or for Bash/WSL
eval "$(msvc-kit setup --script --shell bash)"
# Persist to Windows registry (requires admin)
msvc-kit setup --persistent
```
#### Create Portable Bundle
Create a self-contained bundle with MSVC toolchain that can be used anywhere:
```bash
# Create bundle (requires accepting Microsoft license)
msvc-kit bundle --accept-license
# Specify output directory and architecture
msvc-kit bundle --accept-license --output ./my-msvc-bundle --arch x64
# Cross-compilation bundle (x64 host targeting ARM64)
msvc-kit bundle --accept-license --host-arch x64 --arch arm64
# Also create a zip archive
msvc-kit bundle --accept-license --zip
# Specify versions
msvc-kit bundle --accept-license --msvc-version 14.44 --sdk-version 10.0.26100.0
```
The bundle contains:
- `msvc-kit.exe` - CLI tool
- `VC/Tools/MSVC/{version}/` - MSVC compiler and tools
- `Windows Kits/10/` - Windows SDK
- `setup.bat` - CMD activation script
- `setup.ps1` - PowerShell activation script
- `setup.sh` - Bash/WSL activation script
- `README.txt` - Usage instructions
Usage:
```bash
# Extract and run setup script
cd msvc-bundle
setup.bat # CMD
.\setup.ps1 # PowerShell
source setup.sh # Bash/WSL
# Now cl, link, nmake are available
cl /nologo test.c
```
#### List Versions
```bash
msvc-kit list # Show installed versions
msvc-kit list --available # Show available versions from Microsoft
```
#### Clean Up
```bash
msvc-kit clean --msvc-version 14.44 # Remove specific MSVC version
msvc-kit clean --sdk-version 10.0.26100.0 # Remove specific SDK version
msvc-kit clean --all # Remove all installed versions
msvc-kit clean --all --cache # Also clear download cache
```
#### Configuration
Config file: `%LOCALAPPDATA%\loonghao\msvc-kit\config\config.toml`
```bash
msvc-kit config # Show current config
msvc-kit config --set-dir C:\msvc-kit # Set install directory
msvc-kit config --set-msvc 14.44 # Set default MSVC version
msvc-kit config --set-sdk 10.0.26100.0 # Set default SDK version
msvc-kit config --reset # Reset to defaults
```
#### Print Environment Variables
```bash
msvc-kit env # Print as shell script
msvc-kit env --format json # Print as JSON
```
### Caching & Progress
| Download index | `downloads/{msvc\|sdk}/.../index.db` | redb database for tracking download status |
| Manifest cache | `cache/manifests/` | Cached VS manifests with ETag/Last-Modified |
| Extraction markers | `.msvc-kit-extracted/` | Skip already-extracted packages |
- **Progress display**: Single-line spinner by default. Set `MSVC_KIT_INNER_PROGRESS=1` for detailed file progress.
- **Skip logic**: Downloads are skipped when:
- `cached`: File exists in index with matching hash
- `304`: Server returns Not Modified (ETag/Last-Modified match)
- `size match`: File size matches expected (best-effort, noted in code)
### Library Usage
```toml
[dependencies]
msvc-kit = "0.1"
```
```rust
use msvc_kit::{download_msvc, download_sdk, setup_environment, DownloadOptions};
use msvc_kit::{list_available_versions, Architecture};
#[tokio::main]
async fn main() -> msvc_kit::Result<()> {
// List available versions from Microsoft
let versions = list_available_versions().await?;
println!("Latest MSVC: {:?}", versions.latest_msvc);
println!("Latest SDK: {:?}", versions.latest_sdk);
// Download with builder pattern
let options = DownloadOptions::builder()
.target_dir("C:/msvc-kit")
.arch(Architecture::X64)
.build();
let msvc = download_msvc(&options).await?;
let sdk = download_sdk(&options).await?;
let env = setup_environment(&msvc, Some(&sdk))?;
println!("cl.exe: {:?}", env.cl_exe_path());
Ok(())
}
```
See [Library API Documentation](docs/api/library.md) for full API reference.
### Architecture Support
| `x64` | ✓ | ✓ | 64-bit x86 |
| `x86` | ✓ | ✓ | 32-bit x86 |
| `arm64` | ✓ | ✓ | ARM64 |
| `arm` | - | ✓ | ARM 32-bit (target only) |
### License
MIT License - see `LICENSE`.
**Important: Microsoft Software License Notice**
The MSVC compiler and Windows SDK downloaded by this tool are property of Microsoft
and subject to [Microsoft Visual Studio License Terms](https://visualstudio.microsoft.com/license-terms/).
- **msvc-kit** itself is MIT licensed
- MSVC Build Tools and Windows SDK are **NOT redistributable** - users must download them directly
- By using `msvc-kit download` or `msvc-kit bundle --accept-license`, you agree to Microsoft's license terms
- This tool automates the download process; it does not redistribute Microsoft software