Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

doctor

gwt doctor diagnoses the gwt installation and the managed diffity runtime.

Usage

gwt doctor           # print a health report
gwt doctor --fix     # repair any failing checks (reinstall runtime, etc.)

Checks

  • git repo — the current directory is a git repository.
  • zellij — the zellij binary is installed and runnable.
  • gwt.toml — the project has been initialized (.gwt/config.toml exists).
  • worktrees — the worktree directory configured in gwt.toml exists.
  • Diffity runtime — the managed Node + diffity install under ~/.gwt/node-runtime/ is healthy and matches the versions pinned in this gwt release.

--fix

When --fix is passed, any failing check is repaired if a repair path exists. Currently this reinstalls the diffity runtime (wipes ~/.gwt/node-runtime/ and re-runs the same install that gwt init does).

Re-run after a gwt upgrade to pick up new pinned versions of Node or diffity.