Back to Beta Center•Installation Guide 2.0Estimated Setup Time: ~2 minutes

Xeyria Installation Wizard

Follow our step-by-step wizard to install the VS Code Extension, link your project codebase, and verify context synchronization.

Installation Setup Checklist

Follow the sequence to complete your Xeyria beta setup.

Current Step1 of 6
Estimated setup time: ~2 minutes
☐ Create Account

Account created with email & password

☐ Verify Email

Confirm verification email sent to inbox

☐ Download Extension

Download sideloadable VSIX package

☐ Install VSIX

Install extension package in VS Code

☐ Sign In

Authenticate client extension session

☐ Connect Project

Link repository workspace to sync context

Prerequisites & System Requirements

VS Code Version

v1.85.0 or higher

Requires modern VS Code extension host APIs.

Active Network

Internet Connection

Required to sync context graphs to SaaS workspace.

Git Repository

Initialized Git Repo

Workspace directory must contain a git repository.

Operating System

Win / macOS / Linux

Supports Windows 10/11, macOS, and Linux x86/ARM.

Step ProgressStep 1 of 4
1

Download Extension Package

Obtain the latest sideloadable VSIX binary

Since Xeyria is currently in Closed Beta, the extension is distributed directly as a packaged VSIX binary rather than through the public marketplace.

Screenshot Placeholder 1: Xeyria Direct VSIX Download CenterVS Code UI View
+-------------------------------------------------------------+
| Xeyria Download Center - Closed Beta                       |
| File: xeyria-vscode-0.1.0.vsix                              |
| Size: ~1.07 MB | Status: Ready for Sideloading              |
+-------------------------------------------------------------+

Founder Tip

Store the downloaded `.vsix` file in a dedicated tools directory so you can easily locate it during installation.

2

Install from VSIX in VS Code

Sideload the extension into your VS Code editor

  1. Open VS Code.
  2. Open the Extensions panel by pressing Ctrl+Shift+X or Cmd+Shift+X.
  3. Click the More Actions ... ellipsis menu button at the top-right of the Extensions panel.
  4. Select Install from VSIX... from the menu options.
  5. Select the downloaded xeyria-vscode-0.1.0.vsix file and click Install.
Screenshot Placeholder 2: VS Code Extensions Menu with "Install from VSIX..." optionVS Code UI View
+------------------------------------------+
| EXTENSIONS                               |  ... [ Click Ellipsis ]
+------------------------------------------+  |
| Search Extensions in Marketplace        |  +-- Install from VSIX...  <-- Click
+------------------------------------------+  |-- Views
                                              |-- Check for Updates

Founder Tip

Pro Tip: You can also drag and drop the downloaded `xeyria-vscode-0.1.0.vsix` file directly into your VS Code Extensions sidebar to trigger installation.

3

Authenticate Account & IDE Linking

Connect your editor session to your Xeyria SaaS account

  1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
  2. Run the command: Xeyria: Authenticate Client.
  3. Your default browser will launch the Xeyria login portal. Input your credentials and sign in.
  4. Accept the browser prompt to open the redirect callback back in VS Code.
  5. Expected Status: The status bar will show Xeyria: Connected and the Xeyria logo will appear in your Activity Bar.
Screenshot Placeholder 3: Browser Authentication Callback & Connected StatusVS Code UI View
+-------------------------------------------------------------+
| Xeyria Authentication Successful                            |
| Redirecting to VS Code...                                    |
| Status Bar Output: [ Xeyria: Connected ]                    |
+-------------------------------------------------------------+

Founder Tip

If the browser redirect callback is blocked by an ad-blocker, re-run `Xeyria: Authenticate Client` in the Command Palette.

4

Connect Project & Verify Live Sync

Link your git directory and observe context tracking

  1. In your VS Code window with your project folder open, press Ctrl+Shift+P.
  2. Run command: Xeyria: Connect Project.
  3. Select your project from the quick-pick dropdown.
  4. Make a minor edit in any file and save. The status bar will briefly show Xeyria: Syncing... and return to Connected.
Screenshot Placeholder 4: Xeyria Explorer Sidebar & Live Session TimelineVS Code UI View
+----+ +-------------------------------------------------------+
|    | | XEYRIA EXPLORER                                       |
| (X)| | > Health Score: 98% (Healthy)                       |
|    | | > Technologies: Next.js, TypeScript, PostgreSQL      |
|    | | > Recent Activity: File edit synced (2s ago)          |
+----+ +-------------------------------------------------------+

Founder Tip

Security Guarantee: Plaintext credentials, passwords, and `.env` variables are automatically filtered on your device before synchronization.

Step 1 of 4
Troubleshooting & Common Issues

Encountering setup issues?

Quick resolutions for common beta installation & connection scenarios.