✨ 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.

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, leading to highly relevant and accurate suggestions.
• 🤖 A Full Team of AI Agents: Repo Pilot simulates a team of specialized AI agents—from a Coder to a BugFixer to a Frontend Expert—to provide comprehensive, well-thought-out solutions.
• 🔒 Secure and Integrated: Your API key is stored securely in your local VS Code settings, never in your code. The entire experience is seamlessly integrated into the familiar VS Code UI.
• 💡 Intelligent Code Actions: The "Insert Code" button is smarter than ever. It can create new files or update existing ones, automating boilerplate and setup work.

Quick Start Guide

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

1. Install Extension

2. Set Your API Key (CRITICAL FIRST STEP)

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

1. Open the Command Palette: Ctrl+Shift+P (on Windows/Linux) or Cmd+Shift+P (on Mac).
2. Type Preferences: Open User Settings (JSON) and select it. This will open your settings.json file.
3. Add the following line inside the main JSON object, replacing "YOUR_API_KEY_HERE" with your actual key:

   "repo-pilot.apiKey": "YOUR_API_KEY_HERE"
   

4. Save the settings.json file. The extension will now have access to your key.

3. Launch and Use Repo Pilot

1. Launch the Panel:

   • Open the Command Palette again (Ctrl+Shift+P or Cmd+Shift+P).
   • Type Start Repo Pilot and press Enter.
   • Alternatively: Go to the Explorer view on the left. You should see a new rocket icon (🚀) in the view's title bar. Click it.

2. Interact with the Chat:

   • The "Repo Pilot" panel should now be open. It will greet you with its initial message.
   • Type a prompt into the input box at the bottom, like: "Write a python function to calculate a fibonacci sequence".
   • Press Enter and watch the AI stream its response.

Features

Provide File Context

To make the AI's response more accurate, reference files from your workspace by typing @ followed by the filename. You can add as many as you need.

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

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.

Using the "Insert Code" Button

The "Insert Code" button has two powerful modes:

1. Smart Insert (File Creation/Update): When the AI generates code for a specific file, the "Insert Code" button will automatically:

   • Create the file (and any needed subdirectories) if it doesn't exist.
   • Overwrite the entire content of the file if it already exists.
   • Open the file in your editor.

   This is perfect for generating new components, services, or modules from scratch.

2. Insert at Cursor: If the AI provides a generic code snippet without a specific file path, the button will insert the code directly where your cursor is in your currently active editor file.

Using the "Run" Button

The "Run" button makes executing AI-suggested commands quick and safe:

1. Command Execution with Approval: When the AI suggests a terminal command (e.g., git, npm, or bash), the Run button will:

   • Prompt you for confirmation before running anything.
   • Execute the command in a dedicated Repo Pilot terminal within VS Code once you approve.
   • Preserve the terminal output so you can review logs or results later.

   This is ideal for actions like committing code, installing dependencies, or running build scripts without copy-pasting commands manually.

2. One-Click Productivity: Instead of switching contexts to type commands yourself, you can run them instantly from the AI's suggestion—keeping your workflow smooth and focused.

Activating Agent Mode

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

1. 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.

   • How to Activate: Click the "Agent Mode" toggle switch in the Repo Pilot header.
   • 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.

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 and Agent Mode are mutually exclusive. Enabling one will automatically disable the other. Research Mode does not have access to your local workspace files.

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 header 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.

💖 Support This Project

If Repo Pilot has saved you time, boosted your productivity, or simply made coding more fun, consider buying me a coffee! Your support helps me keep improving and adding new features.

☕ Buy Me a Coffee via PayPal : https://paypal.me/deva9078

Every contribution, big or small, makes a real difference. Thank you for supporting open-source development!

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/H7y0tLoyyA0

Happy Developing!