Engine troubleshooting
Fix missing CLIs, failed authentication, model errors, and path differences.
“CLI not found”
- Open a terminal and run the CLI directly.
- Confirm the command is an executable, not only a shell alias or function.
- Restart Brainwrite after installation.
- Set the exact executable in Settings → Engines if automatic detection still fails.
Apps opened from Finder or the Dock often get a different environment from your Terminal, so an engine that works in Terminal may not be found.
Authentication failures
Run the provider's own status or login command in a terminal. Brainwrite uses the CLI's authenticated session; installing the binary alone is not enough.
A 401 Unauthorized response from api.openai.com means the launched Codex process did not receive valid authentication. Confirm codex login status, sign in again if needed, then restart Brainwrite. Do not paste a ChatGPT password into Brainwrite.
A selected model fails
- Refresh the model picker after updating the CLI.
- Choose a model actually available to that provider account.
- Confirm a custom wrapper forwards the model argument and preserves the provider's expected environment.
- Try the provider CLI directly with the same model to separate an account problem from a Brainwrite integration problem.
Codex sandbox mismatch
Brainwrite preserves Codex's resolved network and writable-folder settings when starting a turn. If Codex returns no resolved sandbox or a different mode from the one requested, the turn stops before sending your message. Check the native Codex sandbox setup and selected access mode, then retry. Brainwrite does not silently replace that policy with broader access.