zoxide-doctor
A zero-dependency checkup for zoxide, PATH, and shell initialization.
zoxide-doctor is a small local CLI that explains why a zoxide setup is not working. It verifies that the binary is on PATH, checks zoxide init for the selected shell, looks for active initialization in common shell profiles, reports optional fzf availability, and can emit machine-readable JSON.
I built it because several different setup mistakes all surface as the same frustrating “command not found” symptom. The tool is read-only, does not modify shell configuration, has no runtime dependencies, and runs on Linux, macOS, and Windows.
This is an independent community tool, not an official zoxide project.