Troubleshooting
Start here
Section titled “Start here”Run the doctor:
npx dxai-cli doctorIt checks: configs parse, required env vars, npx on PATH, and project files referenced in the manifest still exist. Exits non-zero on errors.
Common issues
Section titled “Common issues””Profile not found”
Section titled “”Profile not found””Either the named profile doesn’t exist in ~/.dxai/profiles/ and ./.dxai/, or the path you passed doesn’t resolve. List with dxai-cli profiles.
MCP server selected but doesn’t work
Section titled “MCP server selected but doesn’t work”Most likely: the server needs an env var that isn’t set. Run dxai-cli doctor to see which env vars are missing, or check the Registry / MCP servers page.
Want to start over
Section titled “Want to start over”npx dxai-cli cleanupRemoves everything dxai installed (manifest-aware — won’t touch entries you added by hand).
dxai-cli update fails
Section titled “dxai-cli update fails”dxai falls back to the bundled registry when the remote is unreachable, so the CLI keeps working offline. To check what URL it’s hitting: echo $DXAI_REGISTRY_URL (empty means the default GitHub URL).