> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegandalf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# gandalf doctor: check readiness for setup portability

> Run a readiness report on the target machine before importing a bundle or applying a manifest. Reports missing tools and env keys without installing anything.

`gandalf doctor` checks whether the local machine is ready to accept an imported bundle or an applied manifest. It reports missing tools, missing required environment variables, and other readiness issues. Doctor never installs packages or restores secrets.

## Synopsis

```bash theme={null}
gandalf doctor [flags]
```

## Flags

| Flag              | Description             | Default                          |
| ----------------- | ----------------------- | -------------------------------- |
| `-p`, `--project` | Project directory       | `.`                              |
| `--home`          | Home directory          | `$HOME`                          |
| `--store`         | Gandalf store directory | `~/.gandalf` or `$GANDALF_STORE` |
| `--agent`         | Focus a single agent    | (all)                            |
| `--scope`         | Focus a single scope    | (all)                            |
| `--json`          | Emit JSON output        | off                              |

## Examples

```bash theme={null}
gandalf doctor --project .
gandalf doctor --agent claude-code --scope user
gandalf doctor --json
```

## Output shape

Text output starts with the target platform, then lists readiness items with categories and suggested fixes. The command exits non-zero if any item is categorized as blocked.

## Related

* [Bundles guide](/guides/bundles)
* [`gandalf bundle`](/cli/bundle)