Skip to content

daft doctor ​

Diagnose daft installation and configuration issues

Description ​

Diagnose daft installation and configuration issues.

Runs health checks on your daft installation, repository setup, and hooks configuration. Reports issues with actionable suggestions.

When run outside a git repository, only installation checks are performed. Inside a daft-managed repository, repository and hooks checks run too.

The --fix flag auto-repairs: missing command symlinks, missing shortcut symlinks for partially-installed styles, orphaned worktree entries, incorrect fetch refspecs, missing remote HEAD, non-executable hooks, and deprecated hook names. Issues requiring manual intervention (binary not in PATH, git not installed, shell integration) show suggestions only.

Use --fix --dry-run to preview planned actions with pre-flight validation. Each action shows whether it would succeed or fail (e.g., directory not writable, conflicting files). Actions marked + would succeed; actions marked x would fail, with the reason shown below.

Usage ​

daft doctor [OPTIONS]

Options ​

OptionDescriptionDefault
-v, --verboseShow detailed output for each check
--fixAuto-fix issues that can be resolved automatically
--dry-runPreview fixes without applying them (use with --fix)
-q, --quietOnly show warnings and errors
--all-reposCheck every cataloged repository, not just the current one

Global Options ​

OptionDescription
-h, --helpPrint help information
-V, --versionPrint version information

See Also ​

Released under MIT or Apache-2.0.