Skip to main content

Quick Start

Prerequisites​

Before using CodeVista: AI Coding Assistant, make sure the following requirements are met:

RequirementDetails
Visual Studio CodeLatest stable version recommended
CodeVista AccountA valid corporate CodeVista account
CodeVista ExtensionDownload the .vsix package from the CodeVista website or obtain it from the CodeVista team
Network AccessAccess to the CodeVista service and Keycloak authentication portal
Disk SpaceApproximately 300 MB of free space
note

This guide is for installing CodeVista from a VSIX package. If CodeVista is available through your organization's internal Marketplace, you can install it directly from the Extensions view.

Installation​

Follow the steps below to install the CodeVista extension manually using the provided VSIX package.

Step 1: Open Install from VSIX​

  1. Open Visual Studio Code.
  2. Open the Extensions view by clicking the Extensions icon in the Activity Bar (macOS: Cmd + Shift + X — Windows/Linux: Ctrl + Shift + X).
  3. Click the More Actions (...) button at the top of the Extensions panel.
  4. Select Install from VSIX...

Open Install from VSIX

Step 2: Select the CodeVista VSIX Package​

In the file browser:

  1. Navigate to the folder containing the CodeVista installation package, such as Downloads or Desktop.
  2. Select the CodeVista .vsix file.
  3. Click Install to begin the installation.

Select the CodeVista VSIX Package

Step 3: Reload Visual Studio Code​

After the installation is complete:

  1. Click the Refresh icon in the Extensions panel to reload the Extensions view.
  2. If prompted, click Reload Window or restart Visual Studio Code.
  3. Wait for CodeVista to initialize.

Reload Visual Studio Code

Step 4: Verify the Installation​

Open the CodeVista extension page in Visual Studio Code and verify that:

  • The extension identifier is aic.codevista.
  • The installed version is displayed correctly.
  • Disable and Uninstall buttons are available, indicating that the extension is installed and active.
  • The CodeVista icon appears in the Activity Bar.

Verify the Installation

Once the CodeVista icon appears in the Activity Bar, the installation is complete and you can proceed to sign in and configure CodeVista.

Signing In with Keycloak​

CodeVista uses Keycloak Single Sign-On (SSO) for authentication. Follow the steps below to sign in and connect the CodeVista extension to the service.

Step 1: Start the Login​

  1. Click the CodeVista icon in the Visual Studio Code Activity Bar.
  2. Click Login with Keycloak.
  3. Visual Studio Code will ask for permission to open the CodeVista authentication page in your browser.
  4. Click Open to continue.

Start the Login

Step 2: Enter Your Credentials​

The browser opens the CODEVISTA BY AI1 sign-in page.

  1. Enter your username or email address.
  2. Enter your password.
  3. Click Sign In.

If your browser has saved your CodeVista credentials, you can select the saved account to sign in more quickly.

If you do not have an account, select Register and follow the registration instructions.

Enter Your Credentials

Step 3: Return to Visual Studio Code​

After successful authentication, the browser displays the message:

You have logged in successfully.

  1. Click Open IDE now.
  2. Your browser or operating system may ask for permission to open Visual Studio Code.
  3. Click Allow to continue (you may select Always Allow if you do not want to see this confirmation again).
  4. Visual Studio Code returns to focus, and the CodeVista panel displays your authenticated session.

Return to Visual Studio Code

note

If Visual Studio Code does not return to the foreground automatically, switch back to it manually. The Login with Keycloak button should no longer appear, indicating that you are successfully signed in.

Quick Troubleshooting​

IssueResolution
Install from VSIX... is not visibleOpen the Extensions view and use the ... menu at the top of the panel
Installation takes a long timeThe VSIX package is large. Check the VS Code notification area for progress
CodeVista does not appear after installationRefresh Extensions or run Developer: Reload Window
Browser does not open during loginCheck your default browser and network access to the CodeVista authentication service
Login succeeds but VS Code does not reopenClick Open IDE now, approve the browser prompt, then return to VS Code manually
Login fails or account not foundVerify your account credentials or contact the CodeVista administrator
Being redirected to Login panelRefer to this KB for more details: How to fix login issues in CodeVista for VS Code

Support & Resources​

For account access, installation issues, or bug reports, contact your CodeVista administrator or the CodeVista support team.