Home / Docs / Troubleshooting
Reference

Troubleshooting

Most problems have one of a few causes. Find yours below.

Models

ProblemWhat 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 emptyPress Test and fetch models. If the server lists no models, add a model id by hand.
A local model does not answerStart 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 doingIts context window is small. Lower Condense chats past in Settings.

Agents

ProblemWhat to try
An agent seems to do nothingLook at its tab. needs you means it is waiting for you to allow a command.
An agent goes in circlesPress 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 somethingUndo the turn. See Undo and history.
The chat became slow or expensiveCondense it, or carry on in a new agent. See Usage and cost.
An agent was cut off when the app closedIt carries on when the app reopens, or shows Continue.

Images, voice, video and dictation

ProblemWhat to try
The agent says it cannot create imagesNo 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 acceptedA voice belongs to its model. Pick a voice from the list for that model.
A video never arrivesVideos take minutes. The app waits up to 20 minutes, then gives up and says so.

Preview and running

ProblemWhat to try
The preview is emptyA 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

ProblemWhat to try
A push is refusedSomeone else pushed first. Press Pull, then Push.
Cloning a private repository failsConnect GitHub in Settings with a token that has the repo permission.
Compare says it needs GitInstall Git from git-scm.com and restart the app.

The app

ProblemWhat to try
The app asks you to sign in againThe 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.