What is enhanced code intelligence?
Enhanced code intelligence provides advanced code editing capabilities for your Unity project, inside Bezi. This currently includes improved refactoring and compilation error assistance. This guide covers the prerequisites and setup required to enable enhanced code intelligence.Prerequisites
To enable enhanced code intelligence, your project must meet two core requirements:1) .NET SDK installation
You must have the .NET SDK installed globally on your system. This lets Bezi develop a deeper understanding of the code. Default installation locations:- macOS (Intel):
/usr/local/share/dotnet/x64/dotnet
- macOS (Apple Silicon):
/usr/local/share/dotnet
- Windows:
C:\Program Files\dotnet
- Download and install the appropriate .NET SDK for your Unity version from the .NET website
- For Unity-specific .NET requirements, see Unity’s .NET Profile Support documentation
- Close out of, then relaunch the Bezi app
- Navigate to the bottom right. If .NET was the only issue, the enhanced code intelligence UI should be set to active.
2) Project naming convention
Your Unity project name must match its corresponding.sln
file:
- The
.sln
file must be located at the project root (adjacent to the Assets folder) - The filename must exactly match your project name
How to generate the .sln file
-
In Unity, go to
Unity
>Preferences
>External Tools
-
Temporarily set the External Script Editor to Visual Studio Code (or any supported editor)
If you use Cursor and no other IDE, Unity will not recognize it as a supported editor and will not create the .sln file. In that case, install a supported IDE to create the .sln then set the External Script Editor back to Cursor.
-
Check all the boxes for:
- Embedded packages
- Local packages
- Registry packages
- Built-in packages
-
Select
Regenerate project files
-
Confirm the generated
My-Unity-Project.sln
file exists - Restart Bezi app
Status indicators
The enhanced code intelligence service will display different states to indicate its current statusActive
Active
All prerequisites are met and the service is running correctly:
- What it means: Enhanced features are fully operational
- Features available: Improved refactoring and self-healing
- Action required: None - you’re good to go!
Initializing
Initializing
In the initial setup phase:
- What it means: The service is analyzing your project structure
- Duration: This may take a few minutes depending on project size
- Note: You can still submit prompts during initialization, though some features may be limited
Missing dependencies
Missing dependencies
Prerequisites are not met:
- What it means: One or more required components are missing
- Common causes:
.sln
file doesn’t match project name- .NET SDK not installed or not found in PATH
- Action required: Review the prerequisites above and ensure both requirements are met
Inactive
Inactive
An unexpected error has occured:
- What it means: The service encountered an error during initialization
- Action required: Check your project setup, then contact support via our Discord server
Troubleshooting
Solution file not found
- Check that your
.sln
file exists at the project root - Verify the filename matches your project name exactly (case-sensitive)
- If missing, open your project in Unity to regenerate the solution file
Unsupported script editor (Cursor, etc.)
- Install a supported script editor
- Temporarily set that as the External Script Editor
- Follow instructions (above) to regenerate the solution file
- Set the External Script Editor back to Cursor
.NET SDK issues
- Confirm installation:
dotnet --version
- Ensure the SDK version is compatible with your Unity version
- Restart Bezi after installing the SDK
- Check that the SDK is properly added to your system PATH
Service won’t initialize
- Verify both prerequisites are met
- Try closing and reopening your project
- Check for any error messages in the status indicator
- If issues persist, reach out on Discord with your project details