Docs · Reference
Troubleshooting & FAQ
Fixes for the common BetterC0de beta issues — missing providers, models that will not respond, empty previews, unsigned-installer warnings — plus frequently asked questions.
Common problems
| What you see | What to check |
|---|---|
| A provider is missing | Confirm its CLI is installed and signed in from a terminal, then restart BetterC0de and check Settings → Providers. |
| A model cannot respond | Provider connection, internet access, and the account's remaining usage or quota. |
| A preview is empty | The project's dev server must be running and the preview must point at its address. |
| The agent looks at the wrong files | Check the active project folder and the conversation's project context. |
| Windows says Windows protected your PC | Beta builds are unsigned. More info → Run anyway. |
| macOS says the app is damaged / from an unidentified developer | Right-click → Open, or allow it under System Settings → Privacy & Security. |
| Something else behaves unexpectedly | Note the steps that reproduce it and send a report from Console → Report. |
Sending a useful report
Open Console → Report, click Send Report and wait for the confirmation. Another submission is available after a 10-second cooldown. Copy Report copies the visible report if you would rather paste it on Discord — review logs for anything sensitive before posting publicly.
When asking for help, say what you were doing, what you expected and what happened instead.
FAQ
Is BetterC0de free?
Yes, during the beta. The app is free; your AI usage is billed by the provider you connect, exactly as it would be using their CLI directly.
Do I need an API key?
No. BetterC0de uses the login of each vendor's CLI. If a provider only offers API-key auth, you configure that in the vendor's CLI, not in BetterC0de.
Does BetterC0de see my code?
No. Code, prompts and conversations go directly from your machine to the provider. Our servers only receive an anonymous heartbeat and optional crash reports — see Privacy & telemetry.
Which agents are supported?
Claude Code, OpenAI Codex, Cursor Agent and Grok. More are planned; the CLI-based design makes adding one small.
Is it open source?
It will be — the source is published at the end of September 2026 at github.com/kerim0x1/bettercode. Until then the repository holds the documentation.
Windows, macOS, Linux?
Windows 10/11 and macOS (Apple Silicon and Intel) today. Linux is coming.
Can two agents work on the same repo at once?
Yes — use separate worktrees so they do not overwrite each other. See Multi-agent workflows.