Troubleshooting Desktop App issues - BoldCreate Documentation

Find quick fixes and guidance for common sign-in, task, workspace, connection, and update problems in BoldCreate Desktop.

What you’ll learn

Quick fixes that solve most problems
What common messages mean and what to do about them
How to fix problems with signing in, starting tasks, credits, folders, connections, and updates

Try these first

Many problems are solved by one of these steps:

Check your internet connection. BoldCreate needs the internet for signing in and for the agent’s work.
Reload the window. From the menu bar, choose View > Reload, or press Cmd+R (macOS) or Ctrl+R (Windows).
Restart BoldCreate. Quit the app and open it again.
Install any update. If you see an Update button at the bottom of the sidebar, above your profile icon, click it. See Update BoldCreate and Uninstall BoldCreate.

Note: Reloading or restarting stops any task that is running on your computer. Your tasks and their history are kept.

Signing in

Problem or message	What to do
“Sign-in was not completed. Please try again.”	Click Sign in again and finish signing in within 5 minutes. Don’t close the browser tab before you see Signed in to Bold Create.
“Sign-in failed. Please try again.”	Check your internet connection and click Sign in again.
The browser shows Sign-in did not complete	Return to BoldCreate and click Sign in again.
Authentication unavailable – “Unable to verify the current session.”	Check your internet connection and click Try again.
You were signed out unexpectedly	Your session may have ended, for example, because you signed out somewhere else. Sign in again.

See Sign in.

Starting a task

If you can’t send your message, read the hint under the message box:

Hint	What to do
“Loading chat configuration…”	Wait a moment.
“Choose a folder on this computer to start.”	Click Choose folder… and pick a folder.
“Select a repository or environment to start.”	Choose a repository.
“Connect a Git provider to use this repository.”	Connect GitHub, GitLab, or Gitea on the Integrations page.
“Select a branch to start.”	Choose a branch.
“Select an agent.”	Choose an agent, such as Agent.
“No model is available.”	Reload the window. If it continues, try again later.

Other messages:

Message	What to do
“Chat configuration could not be loaded.” / “Repositories could not be loaded.”	Check your internet connection and reload the window.
“Thread already has an active run”	The agent is still working on this task. Wait for it to finish, or click Stop response first.
“Repository agents could not be loaded. Select a cloud agent or try again.”	Choose a different agent, such as Agent, or try again.
“The selected … agent is no longer available. Select another agent.”	Choose a different agent.

While the agent is working

Message	What it means or what to do
“Retrying (1/3) in 2s: …”	The AI service had a brief problem. BoldCreate tries again on its own, up to 3 times.
“Summarizing earlier conversation…”	The conversation is long, so the agent is summarizing the earlier part to keep going. Wait.
“The process running this task exited before it finished”	The task was interrupted, for example, because BoldCreate closed. Click Try Again.
An error appears under the agent’s reply	Click Try Again if it’s shown, or click Retry.

Out of credits

Message	What to do
“Insufficient credits to complete this request.”	Add credits to your account at `[MANAGE_CREDITS_URL]`, then click Retry.
“Your personal monthly budget limit has been reached.”	Ask your organization’s administrator to raise your limit, or wait until next month.
“Your team’s monthly budget limit has been reached.”	Ask your organization’s administrator to raise your team’s limit, or wait until next month.

See Start a task for more about credits.

Attachments

Message	What to do
“A message can include at most 5 attachments” / “Attachment limit reached (5)”	Remove a file, or send the rest in another message.
“Image exceeds 50 MB limit” / “File exceeds 5 MB limit”	Use a smaller file.
“File is empty”	The file has no content. Choose a different file.
“`{file}` is not a supported file type”	Attach a supported type. See Start a task.
“Local tasks accept PNG, JPEG, GIF or WebP images”	Tasks on your computer accept these image types only.
“Image exceeds 5 MB limit for local tasks” / “Images exceed 10 MB in total for local tasks”	Use smaller images, or fewer images in one message.
“`{model}` does not support image attachments”	Choose a model that supports images, or remove the image.

Tasks on your computer

Problem or message	What to do
“That folder cannot be used”	Choose a different folder.
“The task’s folder no longer exists on this computer.”	Put the folder back where it was, or choose it again with Choose folder….
“Choose this folder again to continue this task.” / “Bold Create can’t use this folder any more. Choose it again for local runs.”	Click Choose folder… and pick the same folder.
“This folder isn’t a Git repository” (Changes tab)	Set up Git in the folder to see the agent’s changes. See Review changes.
“This task is still running. Stop it, then delete it.”	Click Stop response in the task, then delete it.
“The task could not be deleted.”	Reload the window and try again.
The agent is waiting and nothing happens	Look for an approval card in the task and click Allow or Deny.

Cloud tasks and connections

Message	What to do
The browser shows Connection did not complete	Return to BoldCreate and click Connect again.
“`{provider}` could not be connected.”	Try again. Make sure you approved access in the browser.
“Gitea could not be connected. Check the server URL and access token, then try again.”	Check the server address (it must start with `https://`) and that your token can access your profile and repositories.
“Connections could not be loaded”	Click Retry.

Files, terminals, and the workspace

Message	What to do
“Connecting to the workspace…”	Wait a moment.
“Disconnected after a period of inactivity.” / “This IDE session was ended.”	Click Reconnect.
“The workspace is paused.”	Click Resume.
“Couldn’t open the workspace.”	Click Try again.
“The workspace starts with the thread’s next message.”	Send a message in the task, then try again.
“The agent is working: files and terminals are read-only until it finishes.”	Wait for the agent to finish.
“A workspace can have at most 6 terminals. Close one to open another.”	Close a terminal you don’t need.

See Browse files and Terminal.

Chats and the app window

Message	What to do
“Unable to load chats”	Click Try again.
“More chats could not be loaded.”	Scroll down again, or reload the window.
“Conversation unavailable”	Click Try again.
“Something went wrong. Please refresh the page.”	Choose View > Reload.

Updates

Message	What to do
“Could not check for updates: …”	Check your internet connection and try Help > Check for Updates… again.
“Could not install the update: …”	Check your internet connection and click Update again.

Notifications

If you don’t get notifications, remember that they appear only when the BoldCreate window isn’t in front. Also check that notifications for BoldCreate are turned on in your computer’s settings.