Troubleshooting

Start with `workspace inspect`, then narrow the problem to authorization, workspace state, server selection, or pending generated changes.

Command not found

Confirm the CLI can run through npx, or install it globally.

Terminal

$ npx @nepopsx/cli --help

$ npm install -g @nepopsx/cli

Not authorized

Run the device flow again. On a server, print the approval URL instead of trying to open a browser.

Terminal

$ nepopsx login

$ nepopsx login --no-browser

Workspace is invalid or nothing renders

Run workspace inspect from the repository root. Then preview sync to see whether NEPOPSX has any pending output and which files it intends to change.

Terminal

$ nepopsx workspace inspect

$ nepopsx sync --preview

Wrong backend endpoint

Inspect the effective endpoint and remove a stale workspace override if necessary.

Terminal

$ nepopsx server show

$ nepopsx server clear

Enrichment was interrupted

Resume from cached service results instead of starting the full analysis again.

Terminal

$ nepopsx workspace enrich --resume