Nova Troubleshooting Checklist

1. Run doctor

yzx doctor

2. Check command ownership

type yzx
command -v yzx

The command should resolve to your Nix profile or Home Manager owner path, not an old ~/.local/bin/yzx wrapper or shell function.

3. Refresh stale flake evaluation

nix profile upgrade --refresh yazelix

Home Manager users update their declared input and run the normal switch.

4. Inspect config

yzx config

The optional root file is ~/.config/yazelix/config.toml. Back it up before manual recovery. Ratconfig exposes invalid fields and exact native-file actions.

5. Keep generated state generated

Do not manually edit:

~/.local/share/yazelix

Relaunch Nova after fixing the owning input. Open sessions keep their existing package and next-session settings.

6. Report precise failures

Useful issue details:

• OS and architecture
• install owner: Nix profile, Home Manager, or one-off nix run
• yzx --version
• yzx doctor
• yzx status or yzx status --json
• exact command output
• whether the problem reproduces in a fresh yzx enter session