Lumo - AI Coding Companion
Your secure AI companion for coding, embedded directly in VS Code.
✨ 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.vsix file.
- Open VS Code.
- Press
Ctrl+Shift+P (or Cmd+Shift+P on Mac).
- Type "Extensions: Install from VSIX..." and select it.
- Choose the downloaded
.vsix file.
- 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.sessionId field.
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-Id cookie 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.0 or 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
| |
