Troubleshooting
Fixes for sign-in problems, missing models, stuck runs and file access errors.
Can’t sign in
- Status stays “Not connected”: check the Backend URL in Settings → Backend — it should open the Proso.ai sign-in page in a browser.
- Browser sign-in completes but the app doesn’t update: return to the app and click Retry. Some browsers block the redirect back to desktop apps; allow it when prompted.
- Corporate network: make sure your proxy or VPN allows the backend domain.
A model is missing
See Models & Visibility → Why a model is missing.
“Budget exceeded” or requests blocked
Your team or personal token budget has hit a hard limit. Your admin can raise it in AskProso, or it resets at the start of the next period. Files on disk are unaffected.
CodeProso can’t read my files
- macOS: allow folder access when prompted, or grant it under System Settings → Privacy & Security → Files and Folders.
- Windows: make sure the folder isn’t blocked by Controlled Folder Access in Windows Security.
- Files ignored by
.gitignoreare skipped by search — pin or@-reference them to include them explicitly.
Agent mode keeps going in circles
- Make the goal checkable: “until
npm testpasses” beats “fix the tests”. - Lower the attempt limit, or switch to Build mode to steer step by step.
- Pin the files that hold the key context.
Undo didn’t restore a file
Checkpoints track files CodeProso changed. Edits you made yourself outside the app after the checkpoint aren’t tracked — use git to recover them.
Reset the app
Sign out, quit CodeProso, and remove its app data folder:
- macOS:
~/Library/Application Support/CodeProso - Windows:
%APPDATA%\CodeProso
Your projects are never stored there.
Still stuck?
Open an issue on GitHub with your app version (Settings → About), OS, and steps to reproduce.