Xeyria — Developer Context & Continuity
Continuous Context and Contextual Continuity for Modern Developers.
Website | GitHub Repository | Issue Tracker
Xeyria is a VS Code extension that automatically maps, tracks, and synchronizes your local development context with the Xeyria SaaS Platform. It allows you to pause and resume work across workspaces, machines, and sessions with zero cognitive loss.
Why Xeyria?
As developers, we switch contexts constantly—between git branches, workspace folders, and projects. Every context switch carries a cognitive penalty:
- Re-orienting to which files were modified and why.
- Remembering which task was in progress.
- Retrieving API tokens, database schemas, and documentation.
- Syncing state across desktop and mobile dashboards.
Xeyria eliminates this friction by capturing your development session automatically, ensuring you can resume work instantly, anywhere.
Key Benefits
- Zero-Friction Context Restorations: Resumes file positions, active modifications, and current intents.
- Deep Cognitive Memory: Maintains local episodic records of local tech stack analyses, active risks, and decisions.
- Privacy-First Telemetry: Locally ignores environment credentials, private keys, and git internal noise before sync.
- Resilient Offline Mode: Queues edits locally and syncs back seamlessly once connection is restored.
Core Features
- Local Tech Stack Mapping: Automatically scans workspace project files (e.g.
package.json) to register active frameworks.
- Event-Driven Telemetry Sync: Debounces file edit keystrokes and queues changes for chronological replay.
- Intelligent Sidebar View: Embedded glassmorphic webview panels for live memory and timeline visualization.
- Robust Status Controller: Displays read-only status and sync feedback directly on your status bar.
Getting Started
1. Installation
Install the Xeyria extension from the VS Code Marketplace, or package it locally and install from VSIX:
- Search for Xeyria in the Extensions sidebar.
- Click Install.
2. Authentication
- Click $(key) Xeyria: Sign In on the status bar or trigger the command palette:
Xeyria: Authenticate Client.
- A browser window will open. Enter your Xeyria credentials.
- Upon successful login, the browser redirects back to VS Code to automatically store your access and refresh tokens.
3. Connect Workspace
- Select $(check) Xeyria: Ready on the status bar or trigger:
Xeyria: Connect Project.
- Select your corresponding workspace project from the drop-down list.
- The status bar will transition to $(broadcast) Xeyria: Connected.
4. Analyze Project
- Trigger
Xeyria: Refresh Resume Context from the command palette.
- Xeyria will analyze your dependencies, update the tech stack database, and pull the latest AI session insights to your sidebar.
High-Level Architecture Overview
Xeyria operates via a highly decoupled, asynchronous event loop:
[ IDE Events ] ──> [ Workspace Service ] ──> [ Event Bus ]
│
▼
[ HTTP Server ] <── [ Ingestion Queue ] <── [ Offline Cache ]
- Workspace Service: Hooked into IDE platform saved, opened, and renamed files.
- Event Bus: Broker dispatching events to local telemetry queues.
- Offline Cache: Buffers telemetry events on disk when disconnected, replaying them sequentially on recovery.
FAQ & Troubleshooting
Why is my status bar stuck in Xeyria: Ready?
It means the extension is authenticated but no workspace project is connected yet. Run Xeyria: Connect Project to bind it.
How is my privacy protected?
All local edits are checked against strict regex exclusions. Files like .env, private keys (.pem, .key), and .git/ files are completely ignored at the source.
How do I pause tracking?
Run the command Xeyria: Pause Telemetry Capture from the command palette or click the pause button.
License
This project is licensed under the MIT License.
