🎯 What is reQ?

reQ is your intelligent coding companion that lives directly in VS Code. Powered by Google Gemini AI, it understands your code, generates complete projects, debugs issues, and helps you build faster than ever before.

Why reQ?

• ⚡ Lightning Fast - Instant responses with streaming output
• 🎨 Project Generator - Create complete websites with one command
• 🔒 Privacy First - Your API keys stay local, conversations are private
• 🎯 Action-Oriented - No confirmation dialogs, just results
• 📁 Smart File Operations - Reads, writes, and organizes your code
• 🔄 Multi-Chat Tabs - Work on multiple conversations simultaneously
• ↩️ Undo Changes - Revert AI modifications with one click

✨ Features

🤖 Intelligent Code Generation

• Generate complete, production-ready websites
• Create full-stack applications with proper structure
• Auto-organize files into logical folder hierarchies
• Include HTML, CSS, JavaScript with modern best practices

📝 File Management

• Read Files - Analyze your existing code
• Write Files - Create or modify files automatically
• Scan Directory - List and explore project structure
• View Diffs - Compare before/after changes
• Undo Changes - Restore previous file versions

💬 Smart Conversations

• Multi-Tab Interface - Manage multiple chat sessions
• Conversation History - Access past discussions
• Streaming Responses - See AI thinking in real-time
• Stop Generation - Interrupt long responses anytime

🎨 Modern UI

• Clean, VS Code-native design
• Dark/Light theme support
• Syntax highlighting for code blocks
• Responsive layout with smooth animations

🚀 Quick Start

Step 1: Install Extension

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

Step 2: Get API Key

1. Visit Google AI Studio
2. Sign in with your Google account
3. Click "Create API Key"
4. Copy the generated key

Step 3: Configure reQ

1. Click the reQ icon in VS Code sidebar
2. Paste your API key
3. Click "Save Key"
4. Start coding! 🎉

💡 How to Use

Basic Commands

"Create a portfolio website"
→ Generates complete portfolio with HTML, CSS, JS

"Read the app.js file"
→ Analyzes your code and provides insights

"Fix the bug in login.js"
→ Identifies and fixes issues automatically

"Add dark mode to my website"
→ Implements dark mode with toggle functionality

Project Generation

reQ automatically creates organized project structures:

"Make a todo app"
→ Creates:
  todo-app/
  ├── index.html (Complete UI)
  ├── style.css (Modern styling)
  └── app.js (Full functionality)

"Build a landing page"
→ Creates:
  landing-page/
  ├── index.html (Hero, features, CTA)
  ├── styles.css (Responsive design)
  └── script.js (Smooth scrolling, animations)

📚 Usage Examples

Example 1: Create a Portfolio

You: "Create a professional portfolio website"

reQ: ✓ Created portfolio/portfolio.html
     ✓ Created portfolio/portfolio.css
     ✓ Created portfolio/portfolio.js
     
     Your portfolio includes:
     - Hero section with introduction
     - Skills showcase
     - Project gallery
     - Contact form
     - Smooth scrolling navigation

Example 2: Debug Code

You: "Why isn't my form validation working?"

reQ: I'll read your form code and identify the issue.
     
     Found the problem in contact.js line 23:
     - Missing event.preventDefault()
     - Fixed validation logic
     - Added error messages
     
     ✓ Updated contact.js

Example 3: Add Features

You: "Add a search feature to my blog"

reQ: ✓ Added search functionality to blog.js
     ✓ Updated blog.html with search bar
     ✓ Added search styling to blog.css
     
     Features included:
     - Real-time search filtering
     - Highlight matching results
     - Mobile-responsive design

🎨 Interface Overview

Chat Tabs

• Create multiple conversations
• Switch between chats instantly
• Close tabs you don't need

File Changes Panel

• View all modified files
• Compare before/after with diff view
• Undo changes with one click

Conversation History

• Access past conversations
• Delete old chats
• Resume previous sessions

🔧 Advanced Features

Smart File Operations

• Auto-corrects typos in filenames
• Creates directories automatically
• Organizes files logically
• Handles relative and absolute paths

Proactive AI

• No confirmation dialogs
• Executes commands immediately
• Makes intelligent assumptions
• Only asks when truly ambiguous

Code Quality

• Generates production-ready code
• Includes proper comments
• Follows best practices
• Responsive and accessible

🛡️ Privacy & Security

• Local Storage - API keys stored in VS Code's secure storage
• No Tracking - We don't collect or store your conversations
• Direct Connection - Communicates directly with Google Gemini
• Your Data - All code stays on your machine

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Report Bugs - Open an issue with details
2. Suggest Features - Share your ideas
3. Submit PRs - Improve code or documentation
4. Spread the Word - Star the repo and share

📝 Roadmap

• [ ] OpenAI GPT integration
• [ ] Local LLM support
• [ ] Code refactoring tools
• [ ] Test generation
• [ ] Documentation generator
• [ ] Git integration
• [ ] Team collaboration features

👨‍💻 Creator

Netesh Sahi

• GitHub: @umeshmehra1010-cloud
• Built with ❤️ for developers

📄 License

MIT License - feel free to use reQ in your projects!