✨ Features
- 💬 Persistent Chat Interface — Beautiful sidebar chat with full conversation history that survives view switches and VS Code restarts.
- 🧠 Context-Aware Responses — Automatically detects your active file, language, and selected code for intelligent assistance.
- ⚡ Code Completion — Get AI-powered code suggestions via the command palette.
- 🔐 Privacy-First — Powered by Proton's Lumo AI with end-to-end encryption.
- 🎨 Custom Branded UI — Elegant purple gradient interface with custom mascot logo.
📦 Installation
From VSIX File (Recommended for Personal Use)
- Download the
lumo-assistant-0.5.0.vsixfile. - Open VS Code.
- Press
Ctrl+Shift+P(orCmd+Shift+Pon Mac). - Type "Extensions: Install from VSIX..." and select it.
- Choose the downloaded
.vsixfile. - Reload VS Code when prompted.
From Source
bash
git clone https://github.com/EvAnLyOrG/lumo-assistant.git
cd lumo-assistant
npm install
npm run compile
Press F5 in VS Code to launch the extension in development mode.
⚙️ Configuration
Setting Up Authentication
- Open VS Code Settings (
Ctrl+,). - Search for "Lumo".
- Enter your Session ID in the
lumo.sessionIdfield.
How to get your Session ID:
- Go to lumo.proton.me in your browser.
- Log in to your Proton account.
- Press
F12→ Application → Cookies. - Find the
Session-Idcookie and copy its value. - Paste it into the VS Code setting.
Note: Lumo Pro subscribers get unlimited usage. Free tier users have weekly quotas.
🎮 Usage
Chat Interface
- Click the Lumo icon in the Activity Bar (left sidebar).
- Type your message and press Enter or click Send.
- Your conversation history is automatically saved and restored.
Code Suggestions
- Open a code file.
- Type a partial line (e.g.,
const x =). - Press
Ctrl+Shift+P→ "Lumo: Suggest Code". - The AI will insert a context-aware suggestion at your cursor.
Clear Chat History
Click the "Clear Chat" button in the chat header to erase all conversation history.
⌨️ Keyboard Shortcuts
| Command | Shortcut | Description |
|---|---|---|
lumo.suggest |
Alt+/ |
Generate code suggestion at cursor |
To customize: Open Keyboard Shortcuts (
Ctrl+K Ctrl+S) and search for "Lumo".
🛠️ Commands
| Command | Description |
|---|---|
Lumo: Sign in |
Authenticate with your Proton account |
Lumo: Sign out |
Clear your authentication session |
Lumo: Suggest Code |
Generate AI code suggestion |
📋 Requirements
- VS Code
1.85.0or higher - A Proton account (for Lumo access)
- Internet connection
🔒 Privacy & Security
This extension uses Proton's Lumo API, which features:
- End-to-end encryption for all messages
- Zero-access encryption (Proton cannot read your chats)
- No data sold to third parties
Your Session ID is stored locally in VS Code's secure settings and never transmitted elsewhere.
🐛 Known Issues
- Code completion may take 2-5 seconds due to API latency
- Session IDs expire periodically and need to be refreshed
- Inline completion (ghost text) is not yet supported
🗺️ Roadmap
- Native OAuth authentication flow
- Inline code completion (ghost text)
- Multiple conversation threads
- Custom system prompts
- Streaming text display
📄 License
This project is licensed under the MIT License — see the license file for details.
🙏 Acknowledgments
- Proton for the Lumo AI platform
- VS Code Team for the excellent extension API
- The open-source community for inspiration
Made with 💜 by Evanly