Troubleshooting
Quick fixes for the most common CodexUse issues.
| Issue | Fix |
|---|---|
| Can’t log in / auth loop | Retry login in your browser. If headless, use device auth. Check system clock skew. |
| CodexUse CLI not found | Run npm install -g codexuse-cli, then restart your terminal. |
brew upgrade --cask codexuse fails with App source '/Applications/CodexUse.app' is not there |
Old Homebrew metadata still thinks 2.5.8 is installed, but the old app bundle is already gone. Run brew uninstall --cask --force hweihwang/codexuse/codexuse, then brew install --cask hweihwang/codexuse/codexuse. |
| Rate limit data missing | Codex CLI must be installed and reachable. Use --no-usage if you just need profiles. |
| Duplicate account warning | If two profiles resolve to the same underlying OpenAI identity, they will share the same rate-limit headroom. Being in the same ChatGPT Business workspace alone does not create separate limits. |
| MCP server fails to start | Check protocol (stdio/http/sse) and run the command manually to confirm. |
| Auto-roll not switching | Auto-roll triggers only when idle and usage crosses your threshold. |