# marmot doctor (/docs/commands/doctor)

<!-- Generated by scripts/gen.mjs from `marmot doctor --help` and scripts/commands.mjs. Do not edit by hand. -->

Check what marmot needs (its code generator and runtime, the go command, LLVM, the system linker), the build cache and free disk, how output is chosen here, and on macOS whether new binaries start slowly; print what to fix.

```text title="Usage"
marmot doctor [flags]
```

## Examples [#examples]

```sh
marmot doctor
marmot doctor -json
```

Run it first when something does not work. Each check prints a status and, when it fails, the
command or setting that fixes it. `-json` writes one `doctor` object per check (`check`,
`status`, `detail`, `fix`) and a `result`.

## Flags [#flags]

Flags take one dash or two: `-release` and `--release` are the same.

| Flag | Meaning |
| --- | --- |
| `-color string` | color in human output: auto, always or never (NO_COLOR turns auto off) (default "auto") |
| `-json` | machine readable output: JSON Lines on stderr (also $MARMOT_OUTPUT=json, and the default under coding agents) |

## Full help [#full-help]

```text title="marmot doctor --help"
Check what marmot needs (its code generator and runtime, the go command, LLVM, the system linker), the build cache and free disk, how output is chosen here, and on macOS whether new binaries start slowly; print what to fix.

Usage:
  marmot doctor [flags]

Examples:
marmot doctor
marmot doctor -json

Flags:
      --color string   color in human output: auto, always or never (NO_COLOR turns auto off) (default "auto")
  -h, --help           help for doctor
      --json           machine readable output: JSON Lines on stderr (also $MARMOT_OUTPUT=json, and the default under coding agents)
```