ETERNIX2 — VS Code Extension
ETERNIX2 is a local-first autonomous engineering agent for Visual Studio Code. This extension connects VS Code to the ETERNIX2 backend API, giving you chat, task management, workspace operations, tool execution, and service health monitoring directly inside your editor.
Product Identity
- Extension: ETERNIX2
- Publisher: Adjai Tech Labs (
AdjaitechLabs)
- Extension ID:
AdjaitechLabs.eternix2
- Version: 1.0.0
- Target: Visual Studio Code
Objectives
- Bring the ETERNIX2 autonomous engineering agent into VS Code as a native extension.
- Provide a local-first AI coding assistant — nothing leaves your machine unless you configure it to.
- Enable chat, task planning/execution with approvals, workspace file operations, and service health monitoring from within the editor.
Features Currently Implemented
| Feature |
Description |
| Chat |
Conversational interface with ETERNIX2 via a webview panel (eternix2.chatView). |
| Tasks |
Start, cancel, and approve engineering tasks with step-by-step progress tracking (eternix2.taskView). |
| Activity |
Monitor model status, inference diagnostics, and service health (eternix2.activityView). |
| Commands |
ETERNIX2: Chat, Start Task, Cancel Task, Approve Action, List Models, Select Model, Open Workspace, Show Status. |
| Configuration |
eternix2.apiEndpoint, eternix2.apiToken, eternix2.autoStart, eternix2.defaultModel. |
| Backend Auto-Start |
Optionally launches the ETERNIX2 backend (main.py --web) on VS Code startup. |
| Authentication |
Token-based auth stored in VS Code global state. |
| Diagnostics |
Diagnostic collection for inference and model health. |
Requirements
- Visual Studio Code version 1.85.0 or later.
- The ETERNIX2 backend running locally (default:
http://127.0.0.1:5000).
- Python 3.x to run the backend (if auto-start is enabled).
- At least one local model server (llama.cpp compatible) for inference.
Installation
From VSIX (local installation)
- Download
eternix2-1.0.0.vsix from the release assets.
- Open VS Code.
- Open the Extensions view (
Ctrl+Shift+X / Cmd+Shift+X).
- Click the
... menu and select Install from VSIX.
- Select the downloaded
eternix2-1.0.0.vsix file.
- Reload VS Code when prompted.
From source
cd apps/vscode-extension
npm install
npm run compile
npm run vscodeprepublish # compiles and prepares for packaging
Then package with vsce package or use the repository build script:
# PowerShell
.\apps\vscode-extension\build.ps1
# Bash
./apps/vscode-extension/build.sh
Configuration
Open VS Code Settings (Ctrl+, / Cmd+,) and search for ETERNIX2:
| Setting |
Type |
Default |
Description |
eternix2.apiEndpoint |
string |
http://127.0.0.1:5000 |
ETERNIX2 backend API endpoint. |
eternix2.apiToken |
string |
"" |
Authentication token for the backend. |
eternix2.autoStart |
boolean |
true |
Automatically start ETERNIX2 backend on VS Code startup. |
eternix2.defaultModel |
string |
"" |
Default model for chat and tasks. |
Commands
All commands are available from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) under the ETERNIX2 category:
| Command |
Description |
ETERNIX2: Chat |
Open the chat webview. |
ETERNIX2: Start Task |
Prompt for a task description and start it. |
ETERNIX2: Cancel Task |
Cancel the currently running task. |
ETERNIX2: Approve Action |
Approve or reject a pending task action. |
ETERNIX2: List Models |
List available models from the backend. |
ETERNIX2: Select Model |
Select a model to use for chat and tasks. |
ETERNIX2: Open Workspace |
Open a workspace folder for ETERNIX2 operations. |
ETERNIX2: Show Status |
Display backend status in a webview panel. |
Activity Bar Views
The ETERNIX2 activity bar icon provides three views:
- Chat — Send messages to ETERNIX2 and receive responses.
- Tasks — View and manage the current engineering task.
- Activity — Monitor models, inference status, and hardware diagnostics.
Architecture
The extension communicates with the ETERNIX2 backend over HTTP (localhost by default). The backend is a separate Python service that manages model inference, task orchestration, workspace operations, and service health.
┌─────────────────────────────────────┐
│ Visual Studio Code │
│ ┌─────────────────────────────┐ │
│ │ ETERNIX2 Extension │ │
│ │ (chat, tasks, activity) │ │
│ └──────────────┬──────────────┘ │
│ │ HTTP (localhost) │
│ ┌──────────────▼──────────────┐ │
│ │ ETERNIX2 Backend (Python) │ │
│ │ (models, tasks, services) │ │
│ └─────────────────────────────┘ │
└─────────────────────────────────────┘
Dependencies
Runtime
axios — HTTP client for backend API communication.
ws — WebSocket client (optional, for future real-time features).
Development
typescript — TypeScript compiler.
@types/vscode — VS Code API type definitions.
@types/node — Node.js type definitions.
@vscode/vsce — VS Code extension packaging tool.
@vscode/test-electron — Extension test runner.
Troubleshooting
| Issue |
Solution |
| Extension does not activate |
Verify VS Code is version 1.85.0 or later. Check the Output panel for ETERNIX2 errors. |
| Cannot connect to backend |
Ensure eternix2.apiEndpoint points to a running ETERNIX2 backend. Default: http://127.0.0.1:5000. |
| Backend fails to auto-start |
Verify Python is installed and main.py exists in the workspace root. Check eternix2.autoStart is enabled. |
| Commands not appearing |
Reload VS Code Window (Developer: Reload Window from Command Palette). |
| Token/auth issues |
Use ETERNIX2: Show Status to verify connectivity. Re-authenticate if needed. |
Known Limitations
- The extension requires a separately running ETERNIX2 backend; it does not bundle the Python backend or model binaries.
- Backend auto-start spawns
python main.py --web --no-browser in the workspace folder; ensure the working directory is correct.
- No WebSocket-based real-time streaming is currently implemented (HTTP request/response only).
- Model inference is provided by the backend; this extension is a client only.
Development
Prerequisites
- Node.js 18 or later.
- npm.
Build
cd apps/vscode-extension
npm install
npm run compile # Compile TypeScript to ./out
npm run watch # Watch mode for development
Packaging
cd apps/vscode-extension
npx vsce package # Produces eternix2-1.0.0.vsix
Or use the repository build script:
# PowerShell
.\apps\vscode-extension\build.ps1
# Bash
./apps/vscode-extension/build.sh
Testing
No unit or integration tests are currently included in the extension. Manual testing is performed by installing the VSIX and exercising commands and views.
License
MIT License. See LICENSE in the extension directory.
Repository
https://github.com/ETERNIX2/ETERNIX2
Support
For issues and feature requests, open an issue on the ETERNIX2 repository.