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 workspace 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

Install from Visual Studio Marketplace

Official 1-click installation from the Marketplace

The official Xeyria extension is available on the Visual Studio Marketplace for seamless 1-click installation and automatic background updates.

Manual VSIX Fallback (Offline / Air-Gapped)
VS Code Publisher Notice

When installing from the Marketplace, VS Code may prompt: "Do you trust the publisher Xeyria? Xeyria is not verified." Visual Studio Marketplace displays this security prompt for publisher accounts without domain verification badges.

Before proceeding, verify that the extension matches:

  • Publisher: xeyria
  • Identifier: xeyria.xeyria-vscode

Once you have verified these identifiers, you can safely proceed with installation.

Step 1 Preview: Visual Studio Marketplace ListingVS Code UI View
+-------------------------------------------------------------+
| Visual Studio Marketplace - Xeyria (xeyria.xeyria-vscode)   |
| Version: 0.1.1 | Publisher: xeyria | Identifier: xeyria.xeyria-vscode |
| [ Install Button ] -> Auto-launches in your local VS Code   |
+-------------------------------------------------------------+

Founder Tip

Pro Tip: You can also search "Xeyria" directly in your VS Code Extensions tab (Ctrl+Shift+X) and click Install.

2

Open VS Code & Verify Extension

Ensure Xeyria is installed and active in your editor

Follow these quick steps to ensure Xeyria is running in your editor:

  1. Open VS Code.
  2. Open the Extensions panel by pressing Ctrl+Shift+X or Cmd+Shift+X.
  3. Confirm that Xeyria appears under Installed Extensions.
  4. Manual Sideloading Fallback: If installing via VSIX in an air-gapped environment, click the ellipsis (...) at the top of the Extensions view, select Install from VSIX..., and select xeyria-vscode-0.1.1.vsix.
Step 2 Preview: Installed Extension View in VS CodeVS Code UI View
+------------------------------------------+
| EXTENSIONS: INSTALLED                    |
+------------------------------------------+
| (X) Xeyria  v0.1.1                       |
|     Continuous Context & Continuity      |
+------------------------------------------+

Founder Tip

Offline / Air-Gapped Fallback: If you downloaded the VSIX package, you can drag and drop `xeyria-vscode-0.1.1.vsix` directly into your Extensions sidebar to install.

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.
Step 3 Preview: Browser 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.
Step 4 Preview: Xeyria Explorer Sidebar & Live Session SyncVS 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 extension installation & connection scenarios.