Problem
Windows users occasionally encounter silent failures during installation when prerequisites
(Python ≥ 3.11, uv, or Scoop) are misconfigured. The current error messages don't provide
actionable next steps.
Proposed solution
- Add a
grinta doctor command that checks:
- Python version and virtual environment status
uv availability and version
- PATH configuration for Scoop/Homebrew installs
- Git availability and configuration
- Terminal encoding (UTF-8 support)
- Output a clear report with ✅/❌ for each check and suggested fixes for failures
- Run
grinta doctor automatically on first launch if no config file is found
Acceptance criteria
Problem
Windows users occasionally encounter silent failures during installation when prerequisites
(Python ≥ 3.11,
uv, or Scoop) are misconfigured. The current error messages don't provideactionable next steps.
Proposed solution
grinta doctorcommand that checks:uvavailability and versiongrinta doctorautomatically on first launch if no config file is foundAcceptance criteria
grinta doctorruns on Windows, macOS, and Linux