Skip to main content
info

Documentation is currently for moon v2 and latest proto. Documentation for moon v1 has been frozen and can be found here.

diagnose

v0.37.0

The proto diagnose command will diagnose your proto installation for any potential issues. Issues are categorized into errors and warnings, with the former being a must fix, and the latter being a maybe fix (depending on your usage of proto).

$ proto diagnose

Shell: zsh
Shell profile: /Users/name/.zshrc

Errors ────────────────────────────────────────────────────────────────────

- Issue: Bin directory /Users/name/.proto/bin was found BEFORE the shims directory /Users/name/.proto/shims on PATH
Resolution: Ensure the shims path comes before the bin path in your shell
Comment: Runtime version detection will not work correctly unless shims are used

Among other checks, proto inspects your PATH ordering and shell setup, and looks for executable name collisions — multiple configured tools that resolve to the same shim and bin name (for example, the same identifier provided by two different backends). Since only one can be linked, the others are silently shadowed, so these are reported as warnings. v0.58.0

Options

  • --shell - The shell to diagnose (will detect automatically).
  • --json - Print the diagnosis in JSON format.