Troubleshooting
Most problems have one of a few causes. Find yours below.
Models
| Problem | What to try |
|---|---|
| “The provider refused the API key” | Copy the key again from the provider and paste it in Settings. Check that the account has credit. See Connect a model provider. |
| The model list is empty | Press Test and fetch models. If the server lists no models, add a model id by hand. |
| A local model does not answer | Start Ollama or LM Studio. In LM Studio, start the local server. Then fetch the models again. |
| “Connection problem, trying again” | The app retries by itself, up to three times. If it keeps failing, check your internet connection and the provider's status page. |
| A local model forgets what it was doing | Its context window is small. Lower Condense chats past in Settings. |
Agents
| Problem | What to try |
|---|---|
| An agent seems to do nothing | Look at its tab. needs you means it is waiting for you to allow a command. |
| An agent goes in circles | Press Stop. Say what is wrong in one sentence, or start a new agent with a clear request. A stronger model or a higher thinking level also helps. |
| An agent broke something | Undo the turn. See Undo and history. |
| The chat became slow or expensive | Condense it, or carry on in a new agent. See Usage and cost. |
| An agent was cut off when the app closed | It carries on when the app reopens, or shows Continue. |
Images, voice, video and dictation
| Problem | What to try |
|---|---|
| The agent says it cannot create images | No image model is set. Choose one in Settings → Images, voice, video. See that guide. |
| “Choose a transcription model first” | Dictation needs a speech-to-text model. Choose one under Dictation. |
| “No speech was heard” | Open Settings → Images, voice, video, choose the right microphone and press Test. On macOS, allow the app to use the microphone in System Settings → Privacy & Security. |
| A voice is not accepted | A voice belongs to its model. Pick a voice from the list for that model. |
| A video never arrives | Videos take minutes. The app waits up to 20 minutes, then gives up and says so. |
Preview and running
| Problem | What to try |
|---|---|
| The preview is empty | A project that needs a server must be started: press Run project. Or type the address of your server in the address field. |
| “address already in use” | Another copy of the server is still running. Close the old terminal, or press Fix with agent. |
GitHub
| Problem | What to try |
|---|---|
| A push is refused | Someone else pushed first. Press Pull, then Push. |
| Cloning a private repository fails | Connect GitHub in Settings with a token that has the repo permission. |
| Compare says it needs Git | Install Git from git-scm.com and restart the app. |
The app
| Problem | What to try |
|---|---|
| The app asks you to sign in again | The session ended, or the app could not reach the service for a long time. Connect to the internet and sign in. |
| “Time to update” | This version is too old to keep using. Press the update button. |