# Troubleshooting & FAQs A reference for common questions and steps to resolve issues across CodeMate's products and platforms. *** ### VS Code Extension If the CodeMate extension in VS Code isn't loading or working as expected, work through the following steps in order: 1. Reload or restart VS Code. 2. Ensure VS Code is updated to the latest version. 3. Check that the CodeMate extension is up to date. 4. Log out and log back in to the extension to reinitialize any stale sessions. 5. Reinstall the extension if the problem persists. 6. Check for conflicting extensions or background processes that may interfere with CodeMate's operations. 7. Verify whether the issue is isolated to a specific feature or affects the entire extension. If none of these steps resolve the issue, raise a support ticket via our Discord Server with a full description of the problem. *** ### AI Agent (C0 & CORA) The AI Agent is integrated directly within the CodeMate VS Code Extension. All AI-powered features code review, debugging, optimization, and autonomous coding are driven by this embedded agent.
The AI Agent isn't responding to my prompts. Confirm that you're connected to the internet and logged into your CodeMate account. Restart VS Code and ensure both VS Code and the CodeMate extension are up to date. If the subsystem in Toolbox is not running, the agent will be unavailable open Toolbox and verify the subsystem status shows online before retrying.
The code generated doesn't match my expectations. Try refining your input. The AI Agent responds more accurately to detailed prompts with clear structure and intent. Vague or one-line prompts will produce more generic output the more context you provide about your goal, the better the result.
C0 and CORA don't seem to be updating. To get the latest versions, update C0 and CORA directly from the VS Code Extension Marketplace. It's good practice to check for updates periodically, especially after a VS Code extension update.
How can I improve the AI Agent's performance? Keep the extension updated to the latest version, use specific and well-structured prompts, and provide in-app feedback where available. If responses feel slow, check your internet connection and ensure no other resource-intensive processes are competing with the Toolbox subsystem.
*** ### Toolbox
The subsystem takes a long time to start. This is expected behavior on first launch or after a system restart. The subsystem needs to allocate resources and initialize local modules before it's ready to accept IDE connections. Wait for the status indicator to show **online** before opening your IDE. For faster startup, enable Auto-start under **Settings → Subsystem → Auto-start** so the subsystem begins loading as soon as Toolbox opens.
Toolbox isn't connecting to my IDE. If the subsystem is running but your IDE extension isn't connecting, install the CodeMate extensions directly from the IDE Marketplace rather than through Toolbox. Once installed from the marketplace, the extension will connect to the running subsystem automatically.
I'm seeing a warning at installation, or the installer isn't completing. This can occur if network connectivity is interrupted during the download. Check your connection, re-download the installer from [app.codemate.ai/download](https://app.codemate.ai/download), and run it again. If the warning persists on macOS, go to **System Settings → Privacy & Security** and click "Open Anyway."
Can I customize Toolbox's appearance or behavior? Yes. Toolbox supports theme customization and includes two display preferences: **Always on Top** keeps the Toolbox window above other applications, and **Always on Start** launches Toolbox automatically when your system starts. Both can be toggled from the Settings panel.
*** ### FAQs
What is Build and Figma Mode? Build is CodeMate's visual web app builder, accessible from the Web App. To use Figma Integration, click on Figma Mode, authenticate, and paste your Figma file link Build will analyze your design and scaffold a working web application from it.
What file types can I use as input in Build? You can provide text files, Markdown, code, and images as input when working a project in Build.
Can I use custom domains with Build? Yes, custom domain configuration is supported. Upgrade to the Pro version of Build to deploy your web app with a custom domain.
Does CORA have a browser agent? Yes. CORA includes a browser agent capability that allows it to interact with web interfaces as part of an autonomous workflow useful for tasks that require reading from or acting on live web content.
Can I set rules for how the AI behaves in my project? Yes. Rules can be configured at both the project level and globally within CORA. Project-specific rules govern how the agent writes code, structures responses, and follows team conventions. Rules are also configurable through the Web App.
What MCP servers does CodeMate support? CORA supports a growing library of MCP servers. You can browse and connect servers from established MCP marketplaces.
What do I do if responses are slow? Slow responses are most commonly caused by internet connection quality or server load during peak usage times. Check your connection first, then retry. If slowdowns are persistent, try restarting the Toolbox subsystem and ensuring no large background processes are competing for resources.
The complete FAQ is available at [codemate.ai](http://codemate.ai). If the issue persists, you can reach us at . --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.codemate.ai/troubleshooting-and-faqs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.