✨ Repo Pilot - Your AI Copilot for VS Code

Repo Pilot is a powerful AI assistant that lives directly inside your VS Code editor. It's more than just a chatbot; it's your AI forensic team in software development, operating like a squad of secret agents on a code investigation mission — identifying elusive bugs, tracing their origins through complex code paths, and executing precise fixes. It’s a context-aware partner that understands your workspace, helping you write, refactor, and understand code faster than ever before.

Tired of chasing elusive bugs, paying for expensive tools like GitHub Copilot, or juggling multiple coding extensions? Now you can use your own multi-agent AI copilot inside VS Code — powered by your Google Gemini API key.

It doesn’t just talk — it writes code, refactors it, and solves problems with precision.

How to Start Repo Pilot

After installing the extension, you can open the Repo Pilot panel in two ways:

• Bottom status bar Icon: Click the Repo Pilot icon (🚀) in the bottom status bar of the Explorer view.

• OR

• Command Palette: Press Ctrl+Shift+P (or Cmd+Shift+P on Mac), type Start Repo Pilot, and press Enter.

Why You'll Love Repo Pilot

• 🚀 Accelerate Your Workflow: Go from a task description to ready-to-use code in seconds. Repo Pilot doesn't just give you snippets; it can write entire files directly into your project.

• 🧠 Deep Workspace Context: Using the simple @filename syntax, you can give the AI the full context of any file in your workspace—including its relative path—leading to highly relevant and accurate suggestions.

• 🗄️ Query Databases with Natural Language: Revolutionize how you interact with your data.
  • Eliminate Context Switching: Connect securely to your MySQL OR NoSQL database and ask questions in plain English (e.g., "show me the last 5 users who signed up"). Repo Pilot generates the SQL NoSQL based database type configured in setting, runs the query, and displays the results in a clean table—all without leaving your editor.
  • Accelerate Debugging & Development: Instantly verify that your code is writing to the database correctly or pull sample data for a new feature, dramatically speeding up your development cycle.
  • Focus on Insights, Not Syntax: The AI uses your database schema to write the correct queries, freeing you to focus on asking the right questions rather than perfecting SQL or NoSQL syntax. It's a powerful tool for both developers and data analysts.

• 💡 Sharpen Your Skills: Tackle timed data structure and algorithm challenges without ever leaving your editor. Get instant, expert AI feedback on your solutions to prepare for interviews and strengthen your core skills.

• 📊 Integrated Diagram Editor: Visualize your ideas without leaving VS Code. Use simple Mermaid syntax to create, preview, and edit architecture diagrams, user flows, or component hierarchies. Attach them directly to your chat to give the AI precise visual context, leading to more accurate code generation.

• 🦾 Autonomous Agent Mode: Flip a switch and let Repo Pilot take the driver's seat. In Agent Mode, the AI can automatically create files, insert code, and run terminal commands to complete your task from start to finish.

• 🤖 Automated Job Runner: Queue up a series of complex tasks for the AI to execute sequentially. Perfect for batch processing, running automated refactors, or letting the AI build out a new feature overnight.

• 🌐 AI-Powered Browser Automation: Go from plain English to a fully functional Playwright test script.
  • Natural Language Control: Simply tell the AI what you want to do (e.g., "go to google.com and search for 'Repo Pilot'"). Repo Pilot translates your commands into Playwright actions and executes them in a live browser window.
  • Instant Test Generation: As you perform actions, the corresponding Playwright code is generated in real-time, ready to be saved to your project.
• The Full-Stack Investigator: Frontend developer blaming a backend issue? Backend developer blaming a frontend issue? Repo Pilot is here to solve the case 😉. The Investigator doesn't just show you browser events; it can also start and stream live logs from your local server process. See frontend requests and the backend errors they trigger in one unified, time-correlated stream. Select events from both sides to give the AI the complete picture for a truly full-stack root cause analysis.
• AI-Powered Performance Profiling: Stop guessing what's slowing down your app. Get a full performance report with an overall score, Core Web Vitals analysis, and prioritized findings. For any issue, request detailed, step-by-step AI guidance—complete with code examples—to fix it.

• 🌐 Live Web Research: Got a question about a new library or a recent event? Activate Research Mode to let our Research Agent use Google Search. It provides up-to-date answers and cites its sources, perfect for exploring new technologies or understanding current trends.

• 🤖 A Full Team of AI Agents: Repo Pilot simulates a team of specialized AI agents—from a Coder to a BugFixer to a Research Agent—to provide comprehensive, well-thought-out solutions.

• ⚡ Actionable Intelligence: Repo Pilot's suggestions are ready to use.
  • Run Commands: Execute git commands and other shell scripts with a single click in an integrated terminal.
  • Smart Insert: Create new files or update existing ones based on the AI's code, handling file paths automatically.

• Seamless Telegram Integration: Instantly share code snippets, bug reports, and architecture diagrams with your team on Telegram without ever leaving VS Code. The AI intelligently formats each share for maximum clarity, turning your editor into a powerful communication hub.

• 🔒 Secure and Integrated: Your API key and database credentials are stored securely in your local VS Code settings, it never leaves your machine.

• 🎓 AI-Powered Skill Assessments: Go beyond coding challenges. Take AI-generated quizzes on any programming topic to identify your knowledge gaps. Receive a detailed report with an overall score, a breakdown of your weak areas, and personalized lessons from the AI to help you master those concepts. Save your full Q&A and report as a DOCX file to track your progress or share with mentors.

Quick Start Guide

Follow these simple steps to get up and running in under a minute.

1. Install Extension

2. Set Your API Key (IMPORTANT STEP)

The extension won't work without your Google Gemini API key. In the new VS Code window that just opened:

1. Start RepoPilot :
   • click on 🚀 Repo Pilot from the bottom status bar or use command+shift+p.
2. Login to Repo Pilot :
   • get the access key from bot.
3. click on setting
   • after login , click on setting on sidebar of repo pilot.
4. Add Your API Key:
   • find gemini api key input box and add your gemini api key in the gemini input box
5. click on Save the setting :
   • click on Save the setting button. The extension will now have access to your key.

3. Securely Configure Your Database (Optional)

1. Go to the Settings tab :
   • Go to the Settings tab inside Repo Pilot.
2. Select Database Type :
   • Select Database Type – choose MySQL or MongoDB from the dropdown.
3. Connection Detail :
   • Fill Connection Details based on your choice

MySQL Configuration

Scroll down to the Repo Pilot > Mysql section and fill in your credentials.

Sample MySQL Localhost Configuration:

• Host: 127.0.0.1
• Port: 3306
• User: root
• Password: your_secret_password (this will be stored securely)
• Database: my_app_development

MongoDB Configuration

Sample MongoDB Localhost Configuration:

• Connection String: mongodb://127.0.0.1:27017/my_app_development

If your database requires authentication, include the username and password in the string: mongodb://myuser:your_secret_password@127.0.0.1:27017/my_app_development

4. Install Semgrep CLI (Required for Code Analysis)

To use the advanced code analysis feature, you need to install the Semgrep command-line tool.

• For macOS (using Homebrew):

  brew install semgrep
  

• For other systems (using Python's pip):

  pip install semgrep
  

• Verify Installation: Open a new terminal and run semgrep --version. If it prints a version number, you're all set!

5. Configure Telegram for Sharing (Optional)

To share AI responses directly with your team on Telegram:

1. Open Repo Pilot Settingss click on Settings on the Repo Pilot sidebar.
2. Find Telegram Integration: Go to Telegram Integration
3. Add your Bot Token: Find the Repo Pilot > Telegram: Bot Token setting and paste your token. You can get a token by talking to the @BotFather on Telegram.
4. Add your Chats: Find the Repo Pilot > Telegram: Chats setting and click "Add Item". For each person or group you want to share with, you'll need:
   • Name: A friendly name that will appear in the dropdown (e.g., "My Team Channel").
   • Chat ID: The unique ID for the user, group, or channel. See the section below for how to get this.

How to Get Your Telegram Chat ID

The easiest method is to use a bot like @userinfobot.

Troubleshooting Common Issues

If you see a "Chat not found" error, it's usually for one of these reasons:

• Private Chat (1-on-1): The user must start a conversation with your bot first. Ask them to find your bot on Telegram and click "Start".
• Group/Channel: Your bot must be a member of the group. For channels, it must be added as an Administrator.
• Incorrect Chat ID: Group and Channel IDs are negative numbers and often start with -100. Double-check that you've copied the correct ID.

Interacting with the AI

Repo Pilot offers several ways to provide context for your requests:

1. Basic Chat

Simply type any development task or question into the chatbox.

2. Providing File Context with @

To make the AI's response more accurate, reference files from your workspace by typing @ followed by the filename (e.g., @App.tsx). The AI receives the file's full content and relative path, leading to highly relevant suggestions.

Example: "Can you refactor the state management in @App.tsx based on the types defined in @types.ts?"

3. Using Database Mode

Transform how you interact with your data. Database Mode lets you query your connected MySQL database using natural language.

• How to Activate: Click the "Database Mode" (with the Book icon) in the Repo Pilot sidebar. The status indicator in the corner will show if the connection is successful.
• How it Works:
  1. Once connected, simply ask a question about your data (e.g., "show me the last 5 users who signed up").
  2. The generated query and the data results are displayed directly in the chat as a structured table.
• Important: Database Mode is mutually exclusive with Agent, Research, and DSA modes. Enabling it will disable the others.

4. Providing Visual Context with the Diagram Editor

For when a picture is worth a thousand lines of code, use the integrated diagram editor to give the AI clear visual context for tasks like building UIs or scaffolding architecture.

• How to Activate: Click the Diagram icon in the sidebar to open a full-screen editor.
• What it Does:
  • Write diagrams using standard Mermaid syntax in the left panel.
  • See a live, pannable, and zoomable preview render on the right.
  • Click "Attach Diagram" to convert your visual into a PNG and attach it to your message.
• How to Use it: After attaching, add a text prompt and send it. The AI will analyze both the image and your text to generate a precise response.

Example: "Here's the user flow diagram for our new checkout process. Can you write the React components to implement this?"

5. Sharpen Your Skills with DSA Practice Mode

Turn downtime into productive learning. Our integrated DSA Practice Mode helps you prepare for technical interviews and keep your fundamental skills sharp, all within the comfort of your customized VS Code environment.

• How to Activate: Click the "DSA Practice" toggle switch (with the sitemap icon) in the Repo Pilot header.
• What it Does:
  1. Get a Challenge: The AI generates a unique, timed (5-minute) DSA problem.
  2. Choose Your Language: Select from JavaScript, Python, or Java.
  3. Code in Your Editor: Repo Pilot instantly creates a new file in your workspace with the necessary boilerplate and opens it. You write your solution using your full VS Code setup—with your theme, keybindings, and extensions.
  4. Get Expert Feedback: Submit your code with a single click. The AI performs a detailed code review, analyzing correctness, time/space complexity, and code quality, giving you actionable insights that go far beyond a simple pass/fail.
• Why it's Better: Unlike online judges that use a basic web editor, Repo Pilot lets you practice in the same professional environment you work in every day. The solutions are saved directly to your workspace, so you can track your progress over time.

6. Using AI Suggestions (Manual Mode)

When Agent Mode is off, Repo Pilot makes it easy to act on the AI's suggestions with context-aware buttons on every code block.

1. Run Command:

   • What it is: For shell commands (like git, npm, or bash), a "Run" button with a play icon will appear.
   • How it works: Clicking it will prompt you for confirmation. If you approve, the command will be executed in a dedicated "Repo Pilot" terminal within VS Code.

2. Insert Code:

   • What it is: For code blocks that aren't shell commands, you'll see an "Insert" button.
   • How it works: This button has two modes:
     • Smart Insert: If the AI has included a file path comment (e.g., // File: src/components/New.tsx), it will create/overwrite that file with the code.
     • Insert at Cursor: If there's no file path comment, it will insert the code at your current cursor position in the active editor.

7. Activating Research Mode

Get answers to questions about recent events, new technologies, or anything that requires current information from the web.

• How to Activate: Click the "Research Mode" toggle switch (with the globe icon) in the Repo Pilot header.
• What it Does: When enabled, your questions are answered by the Research Agent, which uses Google Search to find the most relevant, up-to-date information. All answers will include a collapsible list of sources.
• Important: Research Mode, DSA Practice, and Agent Mode are mutually exclusive. Enabling one will automatically disable the others. Research Mode does not have access to your local workspace files.

8. Activating Agent Mode

For complex tasks, you can empower the AI to work autonomously by enabling Agent Mode.

• How to Activate: Click the "Agent Mode" icon in the Repo Pilot sidebar.
• What it Does: When enabled, the AI will not just suggest code and commands; it will attempt to execute its plan automatically. It will create/modify files and run terminal commands in your workspace to achieve the goal you've set.
• Monitoring Progress: System messages will appear in the chat, showing you which actions the agent is taking in real-time.
• Use with caution! Agent mode can directly modify your workspace files. It's powerful, but always review the changes it makes.

9. Automate Workflows with the Job Runner

For repetitive or multi-step tasks, the Job Runner is your personal automation engine. Instead of guiding the AI step-by-step, you can create a persistent queue of jobs, select the ones you want to run, and let Repo Pilot execute them sequentially.

• Key Benefits:

  • Batch Processing: Refactor multiple components, generate code for a new feature, or run a series of tests across your codebase with a single click.
  • "Set It and Forget It": Queue up long-running tasks to run in the background or overnight. Your task list is saved to your connected database, so it persists across sessions.Queue jobs once, go grab dinner 🍕 or even sleep 😴. Repo Pilot keeps working — your tasks persist safely in your local DB.
  • Intelligent Pacing: ensuring smooth and reliable execution of even the longest jobs.
  • Full Agent Capabilities: Each task in the job leverages the full power of Agent Mode

• How to Use:

  1. Click the Jobs icon (clipboard with a checkmark) in the sidebar.
  2. Ensure your database is connected (task will be stored in repo_pilot_tasks collection or table in your local database).
  3. Click 'Create Task' to define a job. You can add a description, details, priority, due date, and even paste an image as context.
  4. Select the 'pending' tasks you want to run using the checkboxes.
  5. Click 'Run Job' and sit back, sip your coffee ☕, and watch Repo Pilot do the heavy lifting.

  ✨ With Job Runner, your “to-do list” becomes a “done-for-you” list.

10. AI Browser Mode

Create Playwright tests just by describing what you want to do.

• How to Activate: Click the "Browser" icon (a cursor icon) in the sidebar.

• The Workflow:

  1. Click 'Start Browser' to launch a live browser window.

  2. In the chat input, type natural language commands depending on your environment:

     • 👨‍💻 For Developers: "go to http://localhost:3000/login"
     • 🧪 For Testers: "go to https://staging.example.com/dashboard"
     • 🌍 For Production Testing: "go to https://app.example.com"

  3. Watch the actions happen in the live view and see the Playwright code appear in the history panel.

  4. Copy or save the generated script to your project.

🔹 Live View Tab

For Developers:

• Type natural language commands like “go to https://github.com”.
• Watch the browser perform actions instantly.
• Great for exploring APIs, testing flows quickly, or setting up reproducible states.

For QA/Testers:

• Use plain English to navigate flows without coding.
• Validate UI behavior step-by-step.
• No Playwright knowledge required — just describe what you want to test.

🔹 Investigator Tab

• Start Your Server: Use the integrated server controls to start your local backend process. live logs will stream directly into the Investigator panel.
  • View the Unified Timeline: Reproduce the bug and watch logs appear together in a single, time-correlated stream.
  • Select Evidence: Check the boxes next to the events from both the browser and the server that you believe are related to the bug.
  • Get AI Analysis: In the chat box, ask "What's causing this error?". The AI will analyze the full-stack context you provided and give a root cause analysis and a suggested fix.
  • Generate a Test: Click the "Generate Test" button. The AI will write a complete Playwright script to reproduce the scenario.

For Developers:

• Debug in real time: consolidated live logs.
• Select relevant events as “evidence.”
• Ask AI for root cause analysis and suggested fixes.
• Generate a reproducible Playwright test from selected events.

For QA/Testers:

• Track user actions, requests, and logs in one place.
• Mark steps related to the bug scenario.
• Ask AI: “How do I reproduce this bug?”
• Generate a ready-to-use test case for regression.

🔹 Script Tab

For Developers:

• See Playwright code auto-generated from your actions.
• Edit or extend the script with your own logic.
• Copy directly into your repo for CI/CD pipelines.

For QA/Testers:

• No coding required: actions are converted into ready-made scripts.
• Reuse generated tests in your test suite.
• Share scripts with developers for faster bug reproduction.

🔹 Profiler Tab

Profiler: To analyze performance, switch to the Profiler tab. Click 'Start Profiling Session', interact with your app, then click 'Stop & Analyze'. The AI will generate a full report with a score, Core Web Vitals, and actionable findings. For any finding, you can request detailed AI fix guidance.

11. Sharing with Your Team via Telegram

Once configured, a "Share" icon will appear when you hover over any AI-generated message.

• Click the Share icon: A modal will pop up.
• Select a contact: Choose from the list of chats you configured.
• Add an optional note: Provide extra context for your team.
• Send: Repo Pilot doesn't just send the raw text; it uses the AI to intelligently reformat the content for Telegram. Code snippets get a summary, findings become a neat report, and diagrams are sent as images with their plan, ensuring everything is clear and professional.

12. Advanced Code Analysis with AI Fixes

This powerful workflow allows you to find and fix deep code issues with unprecedented speed.

• How to Use:
  1. Click the Jobs icon in the sidebar.
  2. At the top of the panel, click the "Code Analysis" tab.
  3. Click "Start Semgrep Scan" to perform a deep analysis of your entire workspace.
  4. Review the dashboard of security vulnerabilities and code quality issues.
  5. Use the checkboxes to select the issues you want the AI to fix.
  6. Click "Create Fix Jobs for Selected".
  7. Switch back to the "Task Queue" tab. You will see all the selected issues converted into tasks.
  8. Select these new tasks and click "Run Job" to have the AI agent fix them autonomously.

13. Test Your Knowledge with AI Assessments

Identify and fill your knowledge gaps with personalized quizzes and AI-driven feedback.

• How to Activate: Click the "DSA" icon (sitemap) in the sidebar, then select the "Assessment" tab.
• What it Does:
  1. Start a Quiz: Enter any programming topic (e.g., "React Hooks", "Python Asyncio") and select a difficulty level (Beginner, Intermediate, or Advanced).
  2. Take the Test: The AI generates a unique, 15-question multiple-choice quiz designed to test your conceptual understanding, code analysis skills, and knowledge of best practices.
  3. Get Your Report: After you finish, the AI analyzes your answers and provides a comprehensive report, including:
     • An overall score.
     • A detailed breakdown of your "Skill Gaps"—the specific sub-topics where you struggled.
     • A personalized "Mastery Plan" with in-depth explanations and examples for each identified weak area, helping you turn those weaknesses into strengths.
  4. Save & Share: You can save the entire assessment—questions, your answers, correct answers, and the full AI report—to a DOCX file for later review.

14. Creating a Pull Request

After the AI completes a task and the Git Agent provides commands, you can quickly create a pull request.

• Find the Git Commands: Locate the final message from the AI containing git commands.
• Click "Draft PR": A new "Draft PR" button with a pull request icon will appear next to the "Run" button on that code block. Click it.
• Review & Configure: A modal will pop up where the AI has already generated a title and description based on the conversation. You can select your target repository (if you've configured multiple), confirm the base and head branches, and edit any details.
• Open PR: Click "Open Pull Request", and Repo Pilot will open the PR creation page on GitHub in your browser with everything pre-filled.
• Configuration: For this feature to work, you must add your repository URL(s) in the settings. For long descriptions, a GitHub Personal Access Token with gist scope only required.

💖 Love & Support This Project

Enjoying Repo Pilot? Your support helps ensure continuous improvements and exciting new features — thank you for being part of the journey!

Connect & Explore

1. 📂 GitHub Repo : https://github.com/Agent-C-S-I/Repo-Pilot
2. 💼 LinkedIn : https://www.linkedin.com/in/devdatta-narawade-673903164/
3. ▶️ YouTube Demo link : https://youtu.be/O-KzhkeeEkg

⚡ Note: For the best experience, always keep your Repo Pilot extension up to date. After upgrading, restart the extension to make sure the latest improvements and fixes take effect.

Happy Developing 🇮🇳!