Aether Engine VS Code Extension

🚀 A powerful VS Code extension that integrates with Aether Engine CLI for seamless application deployment and management.

Features

🎯 One-Click Deployment: Deploy your applications directly from VS Code
📊 Real-Time Status: Check application status and health
📋 Log Viewing: View application logs in VS Code editor
🗂️ Application Management: List, delete, and manage deployed applications
🎨 Interactive Dashboard: Beautiful web-based dashboard with real-time updates
⚙️ CLI Integration: Seamless integration with Aether CLI
🔔 Smart Notifications: Get notified about deployment status
🎨 Tree View: Explore applications in the VS Code explorer

Installation

Install the extension from VS Code marketplace
Install Aether CLI globally:
```
npm install -g aether-engine-cli
```
Or use the built-in installer: Ctrl+Shift+P → Aether: Install Aether CLI

Usage

Commands

All commands are available via Command Palette (Ctrl+Shift+P):

Aether: Deploy Application - Deploy the current workspace
Aether: Check Status - Check application status
Aether: View Logs - View application logs
Aether: List Applications - List all deployed applications
Aether: Delete Application - Delete a deployed application
Aether: Configure CLI - Configure Aether CLI settings
Aether: Open Dashboard - Open interactive dashboard

Keybindings

Ctrl+Alt+D (macOS: Cmd+Alt+D) - Deploy Application
Ctrl+Alt+L (macOS: Cmd+Alt+L) - List Applications
Ctrl+Alt+A (macOS: Cmd+Alt+A) - Open Dashboard

Right-click on package.json files to see Aether deployment options.

Dashboard

The interactive dashboard provides:

📊 Overview: CLI status and version information
📦 Application List: All deployed applications with status indicators
🎛️ Quick Actions: Deploy, view logs, check status, delete applications
🔄 Auto-Refresh: Automatic updates every 30 seconds

Open the dashboard with Ctrl+Alt+A or click the Aether icon in the status bar.

Tree View

The Aether Applications tree view in the Explorer shows:

Application names with status indicators
Application details (URL, version, last deployed)
Quick access to status checks

Settings

Configure the extension via VS Code settings:

{
  "aether.cliPath": "/path/to/aether", // Custom CLI path
  "aether.autoRefresh": true, // Auto-refresh application list
  "aether.refreshInterval": 30, // Refresh interval in seconds
  "aether.showNotifications": true, // Show deployment notifications
  "aether.logLevel": "info" // Log level (error, warn, info, debug)
}

Status Indicators

The extension uses color-coded status indicators:

🟢 Green - Running/Active applications
🔴 Red - Stopped/Failed applications
🟡 Yellow - Pending/Deploying applications
⚪ Gray - Unknown status

Supported Platforms

Linux x64/ARM64
macOS x64/ARM64 (Intel/Apple Silicon)
Windows x64

CLI Integration

The extension automatically detects Aether CLI in the following order:

Custom path set in aether.cliPath setting
Local binary in workspace binaries/ folder
Global npm installation (aether command)

Development

Building from Source

git clone https://github.com/secus217/aether-cli.git
cd aether-cli/vscode-extension
npm install
npm run compile

Running Extension

Open in VS Code
Press F5 to launch Extension Development Host
Test the extension in the new window

Packaging

npm run package

This creates a .vsix file that can be installed manually.

Troubleshooting

CLI Not Found

If you see "Aether CLI not found":

Install globally: npm install -g aether-engine-cli
Or set custom path in settings: aether.cliPath
Or use the built-in installer command

Permission Issues

On Linux/macOS, you may need to make the binary executable:

chmod +x /path/to/aether

Network Issues

Ensure you have proper network connectivity and permissions for:

npm registry access (for CLI installation)
Kubernetes cluster access (for deployments)

Contributing

Fork the repository
Create your feature branch
Make your changes
Test thoroughly
Submit a pull request

License

MIT © secus217

Changelog

1.0.0

Initial release
Basic CLI integration
Interactive dashboard
Tree view for applications
Command palette integration
Status bar integration
Deployment notifications

Aether Engine

secus217