VSCodeSensei - Your AI Coding Teacher

VSCodeSensei is an intelligent VS Code extension that helps you learn to code better and resolve errors faster. Choose between Sensei Mode for guided learning or Generator Mode for instant solutions.

Features

🧘 Sensei Mode

• Teaches you how to fix problems, not just what to fix
• Asks thought-provoking questions to guide your learning
• Explains concepts and principles without spoon-feeding code
• Perfect for learning fundamentals and improving your skills

⚡ Generator Mode

• Provides complete, production-ready code solutions
• Includes detailed explanations and best practices
• Fast code generation for rapid development
• Perfect for meeting deadlines and shipping features

🤖 Smart Code Review

• Review current file with AI analysis
• Review git diffs before committing
• Review multiple files together with context
• Chat with AI about your code
• Beautiful markdown-formatted responses

🆓 Free & Secure

• Works out of the box - No API key required!
• Uses secure Cloudflare Worker proxy for free model access
• Rate-limited to prevent abuse (10/min, 100/hr, 1000/day per IP)
• Optional: Add your own API key for unlimited access & premium models
• Star ratings (⭐⭐⭐) show model programming capabilities

Installation(of Deployed version)

From VS Code Marketplace (Recommended)

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "VSCodeSensei"
4. Click Install

Manual Installation

1. Download the .vsix file from Releases
2. Open VS Code
3. Go to Extensions
4. Click "..." → Install from VSIX
5. Select the downloaded file

Screenshots

Support

• 🐛 Report Issues
• 💬 Discussions
• ⭐ Star on GitHub

Installation(For Development)

From VS Code Marketplace (Recommended)

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "VSCodeSensei"
4. Click "Install"
5. Start using immediately - no configuration needed!

From Source (For Development)

git clone https://github.com/SChakraborty04/VSCodeSensei.git
cd codesensei
npm install

Setup Options

Option 1: Use Without API Key (Recommended for Most Users)

No setup required! The extension uses a secure Cloudflare Worker proxy that provides:

• Free access to multiple AI models
• No registration needed
• Rate limiting for fair usage
• Works immediately after installation

Simply install and start using!

Option 2: Add Your Own API Key (For Power Users)

Get unlimited requests and access to premium models:

1. Click the 🔑 icon in the VSCodeSensei panel
2. Get a free OpenRouter API key:
   • Go to OpenRouter.ai
   • Sign up (free)
   • Create an API key
   • Copy the key (starts with sk-or-v1-...)
3. Paste your key in the VS Code prompt
4. Done! You now have unlimited access

Option 3: Development Setup (For Contributors)

If you're contributing to the project:

1. Create a .env file:

cp .env.example .env

2. Add your development key:

# .env file
MASTER_OPENROUTER_KEY=sk-or-v1-your-key-here

3. Run in development mode:

# Press F5 in VS Code to launch

The extension will automatically:

• Use .env key in development
• Use Cloudflare Worker proxy in production
• Never expose your development keys in published versions

Usage

1. Open VSCodeSensei - Click the VSCodeSensei icon in the activity bar
2. Choose Your Mode - Select Sensei (learning) or Generator (solutions)
3. Select a Model - Pick from free models (with star ratings)
4. Review Your Code:
   • Click "📄 Review" to analyze the current file
   • Click "📝 Review Diff" to review git changes
   • Attach multiple files for context
   • Chat with AI about your code

Advanced Features

Multi-File Review

1. Click "📁 Add Files" to attach multiple files
2. Choose review mode:
   • 📄 Current File - Review only active file
   • 📁 Attached Files - Review selected files
   • 🔗 Both - Review current + attached files
3. Files are saved across sessions

Chat with AI

• Type questions in the chat box
• Press Enter to send (Shift+Enter for new line)
• AI includes context from your files
• Get instant answers and code suggestions

Context Modes

• 📁 Specific Files - Manually select files
• 🌐 Workspace - Include entire workspace (up to 20 files)

How It Works

Production Mode (Default)

Your Extension → Cloudflare Worker Proxy → OpenRouter API
                  (Your secure key)

• Zero configuration needed
• API key securely stored in Cloudflare
• Rate-limited for fair usage
• Free for all users

With Your Own Key

Your Extension → OpenRouter API
                  (Your personal key)

• Unlimited requests
• Access to premium models
• Stored securely in VS Code Secrets
• Never shared or exposed

Extension Settings

This extension contributes the following settings:

• aiReviewer.mode: Choose between 'sensei' (teaching) or 'generator' (solutions) mode
• aiReviewer.provider: AI provider to use (openai, gemini, openrouter)
• aiReviewer.openrouter.model: OpenRouter model to use
• aiReviewer.openai.model: OpenAI model to use
• aiReviewer.gemini.model: Gemini model to use

Star Ratings Explained

• ⭐⭐⭐ - Excellent programming capabilities (Score: 12-15)
• ⭐⭐ - Good programming capabilities (Score: 8-11)
• ⭐ - Basic programming capabilities (Score: 4-7)

Models are ranked based on their coding, debugging, and problem-solving abilities.

Rate Limits (Without API Key)

To ensure fair usage for all users:

• 10 requests per minute per IP address
• 100 requests per hour per IP address
• 1,000 requests per day per IP address

If you exceed these limits, you'll see a friendly message. Simply add your own API key for unlimited access!

Security & Privacy

✅ Your code stays private - Only sent to AI for analysis, never stored
✅ API keys encrypted - Stored in VS Code Secrets (AES-256)
✅ No telemetry - We don't track your usage
✅ Open source - Audit the code yourself
✅ Cloudflare protection - DDoS and rate limiting built-in

Troubleshooting

"Rate limit exceeded"

• Solution 1: Wait a few minutes (limits reset hourly)
• Solution 2: Add your own API key (unlimited access)

"Failed to connect to AI service"

• Check your internet connection
• Verify the extension is up to date
• Try adding your own API key

No models showing

• Click the "🔄 Refresh" button
• Restart VS Code
• Check if your firewall blocks OpenRouter.ai

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Support

• 🐛 Report bugs: GitHub Issues
• 💬 Discuss: GitHub Discussions
• ⭐ Star us: If you find this useful!

License

MIT License - See LICENSE file for details

Acknowledgments

• OpenRouter for API access
• Cloudflare Workers for secure proxy
• VS Code team for excellent extension API
• All contributors and users!

Enjoy coding with your AI Sensei! 🧑‍🏫✨