Cybrosys Assista

Troubleshooting ​

This guide provides solutions for common issues you might encounter while using the Cybrosys Assista: Odoo Helper extension in Visual Studio Code.
If your issue isn't listed here, visit our Support page.

Installation Issues ​

Extension Not Found in Marketplace ​

Symptoms:

  • Extension doesn't appear in the Extensions tab
  • Search returns no results

Solutions:

  1. Check your internet connection
  2. Ensure you're running the latest version of Visual Studio Code
  3. Install manually using this CLI command:
    bash
    code --install-extension CybrosysTechnologiesOdooOfficialPartner.cybrosys-assista-odoo-helper

Installation Fails ​

Symptoms:

  • Error during installation
  • Extension doesn't appear after install
  • VS Code freezes or crashes

Solutions:

  • Restart Visual Studio Code and try again
  • Check the logs:
    • Open the Output panel
    • Select Log (Extension Host) or Log (Shared) for error details
  • Ensure your system meets requirements:
    • VS Code v1.70 or later
    • Sufficient disk space
    • Proper file permissions

Configuration Issues ​

Extension Settings Not Saving ​

Symptoms:

  • Preferences reset after restart
  • Custom paths or options lost

Solutions:

  • Check VS Code settings.json file
  • Ensure workspace has write permissions
  • Try setting values in Workspace Settings instead of User Settings

Odoo Path Not Recognized ​

Symptoms:

  • Module generation fails
  • Smart suggestions don't work
  • Snippets or menus missing

Solutions:

  • Make sure Odoo is installed and accessible
  • Verify paths in extension settings:
    • Go to Settings → Extensions → Cybrosys Assista: Odoo Helper
    • Set the Odoo Base Path and any Custom Addon Paths
  • Restart VS Code after updating paths

Feature-Specific Issues ​

Module Template Generator Not Working ​

Symptoms:

  • "Create Odoo Module" not shown
  • Nothing happens after choosing a template

Solutions:

  • Right-click inside a valid addons directory
  • Ensure required folder permissions are granted
  • Reinstall the extension and restart VS Code

File Creator Issues ​

Symptoms:

  • "Create Odoo File" missing from right-click menu
  • File not created after selecting template

Solutions:

  • Right-click on a valid subfolder inside your module
  • Check the selected file type and naming
  • Confirm folder permissions allow file creation

Code Snippets Not Appearing ​

Symptoms:

  • Typing odoo_ shows no suggestions
  • Wrong completions triggered

Solutions:

  • Open a .py or .xml file — snippets are context-aware
  • Make sure your file type is recognized as Python/XML
  • Restart VS Code or reload the window (Ctrl+Shift+P → Reload Window)

Smart Suggestions Not Working ​

Symptoms:

  • No auto-complete suggestions
  • Wrong suggestions or irrelevant fields

Solutions:

  • Confirm your module has proper model and field structure
  • Set correct Odoo paths in extension settings
  • Restart VS Code and try again

Code Inspection Issues ​

Symptoms:

  • Violations not flagged
  • Incorrect warnings
  • Inspection is inconsistent

Solutions:

  • Go to Settings → Extensions → Cybrosys Assista
  • Enable or adjust inspection features
  • Ensure you're editing files in a valid Odoo module structure

Performance Issues ​

Slow Response or Lag ​

Symptoms:

  • Extension features respond slowly
  • VS Code becomes sluggish

Solutions:

  • Disable unused extensions that may conflict
  • Reload the VS Code window (Ctrl+Shift+P → Reload Window)
  • Use smaller test projects if possible to isolate issue

High Memory Usage ​

Symptoms:

  • VS Code consumes a lot of memory
  • Lag or freezing when editing Odoo files

Solutions:

  • Close unused editors/tabs
  • Disable heavy extensions not needed for Odoo
  • Use the Developer: Show Running Extensions command to debug usage

Common Error Messages ​

"Odoo Path Not Found" ​

Solution:

  • Set Odoo base and addon paths in the extension settings
  • Ensure they are accessible and valid

"Template Generation Failed" ​

Solution:

  • Check that the target directory exists
  • Confirm write permissions
  • Restart VS Code and try again

"Command Not Found" ​

Solution:

  • Reload the window (Ctrl+Shift+P → Reload Window)
  • Ensure the extension is enabled and installed correctly

Getting Help ​

If you're still experiencing issues:

Check Documentation

  • Review the Installation Guide
  • Explore Usage Guide
  • Read Best Practices

Community Support

  • Visit our GitHub or discussion forum (if available)
  • Share logs or steps to reproduce the problem

Contact Support

  • Submit a ticket via the Support Page
  • Include your VS Code version, extension version, logs, and screenshots

Next Steps ​

  • Return to the Installation Guide
  • Read the Quick Start Guide
  • Follow Best Practices for optimal setup

Let me know if you want a compressed version for side-panel docs or a matching support ticket form layout next!