Skip to content

Improve Windows installation diagnostics #91

Description

@josephsenior

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

  • grinta doctor runs on Windows, macOS, and Linux
  • Each check outputs a human-readable status with fix suggestions
  • CI includes a Windows runner that exercises the doctor command

Metadata

Metadata

Assignees

Labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions