# Install kdoctor with Homebrew, Nix

Environment diagnostics for Kotlin Multiplatform Mobile app development. Version 1.1.0 via Homebrew; verified 2026-06-22. Also installable with nix: nix profile install nixpkgs#kdoctor.

## Install

```sh
sudo av install brew:kdoctor
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install kdoctor
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kdoctor
```

  Evidence: nixpkgs package indexes: pkgs/by-name/kd/kdoctor/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:kdoctor
- **Package manager:** Homebrew
- **Version:** 1.1.0
- **Source summary:** Environment diagnostics for Kotlin Multiplatform Mobile app development
- **Homepage:** <https://github.com/kotlin/kdoctor>
- **Repository:** <https://github.com/Kotlin/kdoctor>
- **Last updated:** 2026-06-22T14:03:52-07:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- kdoctor (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.1.0
## Project history and usage

KDoctor is a Kotlin-team command-line diagnostic tool for checking whether a macOS development environment is ready for Kotlin Multiplatform Mobile work. It tests the surrounding toolchain rather than compiling Kotlin code itself: operating system, JDK, Android Studio, Xcode, CocoaPods, and related setup details.

### Project history

The GitHub repository was created on 2022-01-17 under the Kotlin organization, and its first public pre-release, v0.0.1, was published on 2022-02-04. The README presents it as a JetBrains incubator project and documents the simple `kdoctor` workflow for diagnosing a Kotlin Multiplatform Mobile environment.

The 2022-05-20 Kotlin Multiplatform Mobile beta roadmap update singled out KDoctor as a tool for improving onboarding. Its release history moved from the 0.0.x series in 2022 to v1.0.0 on 2023-03-15, with v1.0.0 adding project-analysis diagnostics and team-id reporting.

### Adoption history

KDoctor's adoption is tied to Kotlin Multiplatform Mobile onboarding: it is used by developers and support channels to quickly identify missing or mismatched macOS, Android, Xcode, Java, or CocoaPods setup. Homebrew packaging made it convenient for macOS developers to install as a standalone diagnostic command.

### How it is used

The normal workflow is to run `kdoctor` in a terminal and review its report before building or debugging a Kotlin Multiplatform Mobile project. Later releases added more specific diagnostics, including analysis of Gradle project configuration via command-line options.

### Why package nerds care

KDoctor is notable as a single-purpose ecosystem health check: it turns a traditionally fragile mobile cross-toolchain setup into one small package-manager-installable command. For package nerds, it is the kind of glue CLI that captures the real state of an SDK stack better than a version number alone.

### Timeline

- 2022-01-17: GitHub repository created under the Kotlin organization.
- 2022-02-04: v0.0.1 pre-release published.
- 2022-05-20: JetBrains' Kotlin Multiplatform Mobile beta roadmap update highlighted KDoctor for onboarding.
- 2023-03-15: v1.0.0 published with project-analysis diagnostics and team-id reporting.
- 2023-11-01: v1.1.0 published.

### Related projects

- KDoctor is adjacent to Kotlin Multiplatform, Kotlin Multiplatform Mobile, Android Studio, Xcode, CocoaPods, and Gradle. It is diagnostic glue around those projects rather than a replacement for any of them.

### Sources

- <https://api.github.com/repos/Kotlin/kdoctor>
- <https://blog.jetbrains.com/kotlin/2022/05/kotlin-multiplatform-mobile-beta-roadmap-update/>
- <https://github.com/Kotlin/kdoctor>
- <https://github.com/Kotlin/kdoctor/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Other Package-Manager Records

- Nix - kdoctor: normalized package name match | nixpkgs package indexes: pkgs/by-name/kd/kdoctor/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/kdoctor.yml](https://github.com/mxcl/pkgdb/blob/main/combined/kdoctor.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph