Troubleshooting & FAQs

A reference for common questions and steps to resolve issues across CodeMate's products and platforms.

---

VS Code Extension

If the CORA 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 CORA is up to date.

4. Log out and log back in to the ToolBox 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 CORA'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 with a full description of the problem.

---

CORA

CORA extension is integrated directly within the IDE environment. 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 CORA 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.

CORA don't seem to be updating.

To get the latest versions, update CORA directly from the VS Code Extension Marketplace or you can install directly from the ToolBox. 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, 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. If the issue persists, you can reach us at [e-mail].