Master Ruwaan — Your AI Coding Mentor for VS Code
Master Ruwaan is a VS Code extension that brings a serene, wise AI mentor into your coding environment. Ask questions, get code explanations, refactorings, and fixes—all with the gentle guidance of a digital forest sage.
✨ Features
- Conversational AI Chat: Open a persistent chat panel and talk to Master Ruwaan about your code, bugs, or design questions.
- Code Actions: Select code and ask Ruwaan to fix, explain, refactor, or comment—instantly, with a single click.
- Contextual Understanding: Add files from your project as context. Ruwaan’s advice becomes as deep as the forest itself.
- Image Support: Attach screenshots or diagrams to your questions—let Ruwaan see what you see.
- Persistent History: All your questions and answers are saved and beautifully rendered in the chat panel.
- Modern, Themed UI: Enjoy a calm, forest-inspired interface with custom fonts and smooth animations.
🚀 Getting Started
Install the Extension
- Search for
Master Ruwaan
in the VS Code Marketplace and install it.
Set Your Groq API Key
- Open VS Code settings (
Ctrl+,
or Cmd+,
), search for Master Ruwaan
, and paste your Groq API key into the Groq API Key
field.
Open the Chat
- Use the command palette (
Ctrl+Shift+P
or Cmd+Shift+P
) and run Ask Master Ruwaan
.
- Or, click the chat icon in the editor title bar.
Start Asking!
- Type your question, select code to get context-aware help, or add files/images for deeper understanding.
⚙️ Extension Settings
This extension contributes the following settings:
master-ruwaan.groqApiKey
: Your Groq API Key. Required for all AI features.
🧑💻 Usage Tips
- Code Selection: Select code in the editor, then open the chat to get focused help.
- File Context: Add relevant files to your question for more accurate answers.
- Image Attachments: Use the image button in the chat to upload screenshots or diagrams.
- Persistent Chat: All your conversations are saved for your session.
📝 Requirements
- Visual Studio Code v1.100.0 or higher
- A Groq API key (free tier available)
- Internet connection
🐞 Known Issues
- Only supports the Groq API (no OpenAI or other providers yet).
- If you hit the Groq rate limit, you’ll see a gentle message from Master Ruwaan—just wait a moment and try again.
- Some advanced code actions may not work perfectly for all languages.
📦 Development & Contributing
- Clone this repo and run
npm install
in the root folder.
- Press
F5
in VS Code to launch the extension development host.
- The main extension code is in
extension.js
.
PRs and suggestions are welcome!
📜 License
MIT
🙋 FAQ
Q: Is my code or chat data sent anywhere except Groq?
A: No. All requests go directly from your machine to the Groq API.
Q: Can I use my own OpenAI key?
A: Not yet—only Groq is supported for now.
Q: Is this extension free?
A: Yes, but you need a (free) Groq API key.
About Master Ruwaan
Master Ruwaan is a digital forest sage—calm, wise, and focused. He helps you write, fix, and understand code with clarity and patience. If you ever feel lost, just ask: “What is your story, Master Ruwaan?”