Mini Agent
An AI Prompt Generator for VS Code — like Cline or Cursor prompt assistant, but 100% free and no API costs.
Mini Agent sits inside VS Code as a sidebar panel.
It generates smart AI prompts (with workspace file details, instructions, etc.) and you can copy them into ChatGPT / Gemini / DeepSeek / Claude to apply changes back to your code.
🚀 What Makes Mini Agent Different?
✅ No API key needed
✅ Generate prompts locally (no cloud dependency)
✅ Send full workspace context to AI easily
✅ One-click Copy Prompt → Paste into AI → Apply Changes
🧠 Overview
Mini Agent simplifies coding with AI:
- Select what you want the AI to do (fix bug, refactor, generate file, understand code, etc.)
- Mini Agent automatically collects relevant details (file name, language, your text input).
- It generates a professionally formatted AI prompt.
- You paste that prompt into ChatGPT / Gemini / Claude / DeepSeek.
- AI returns improved code → you paste changes back into VS Code.
Think of it as “Cline-like prompt brain” without API dependency.
✨ Features
| Feature |
Description |
| 🧩 Sidebar UI |
Built using React + shadcn/ui |
| 💡 Prompt Templates |
Ready-made templates (Fix Code, Explain Code, Optimize Code, etc.) |
| 🎨 Theme support |
Auto adapts to VS Code Light / Dark |
| ✍️ Custom Prompts (coming soon) |
Save your own prompt workflows |
| 📄 Export Prompts (coming soon) |
Export to JSON / Markdown / shareable text |
| 🤖 Copy Workspace Details |
Prompt includes file path + code context |
| ⚡ One-Click Copy |
Copy prompt directly to AI |
🧑💻 How to Use Mini Agent (Step-by-Step)
✅ Step 1: Open Mini Agent Panel
- Install the extension (see section below).
- Look at VS Code Activity Bar (left side).
- Click the Mini Agent icon (🤖).
Mini Agent sidebar UI will open.
✅ Step 2: Generate a Prompt
Inside the sidebar:
- Select a prompt category
(Examples: Fix Bug, Refactor Code, Explain Code, Create Component, etc.)
- Paste your code or write instructions in the input box.
- Click Generate Prompt.
Mini Agent will create a full AI-ready prompt like:
Task: Fix the bug in this file
File: src/components/Sidebar.tsx
✅ Step 3: Send Prompt to an AI (ChatGPT / DeepSeek / Claude / Gemini)
- Click Copy Prompt
- Paste into any AI chat window:
ChatGPT / Claude / DeepSeek / Gemini (web or app)
- The AI now has all the information it needs:
code
file path
instructions
in expected output format
✅ Step 4: Apply AI Changes Back Into VS Code
- AI will respond with optimized or fixed code.
- Copy the AI output.
- Paste into Apply changes dialog .
Done.
Code refactored → Bug fixed → New feature generated ✅
All with Mini Agent inside VS Code.
🛠 Installation
🟣 Install from VS Code Marketplace
- Open VS Code
- Press:
Ctrl + Shift + X (Windows/Linux)Cmd + Shift + X (Mac)
- Search for "Mini Agent"
- Click Install
🟡 Install via .vsix File
- Download
mini-agent-0.0.1.vsix
- Open VS Code
- Go to Extensions
- Click
... menu (top right)
- Select Install from VSIX
- Choose the downloaded file
🔧 Extension Settings
| Setting |
Description |
miniAgent.defaultTemplate |
Sets default prompt template |
miniAgent.autoSave |
Auto-save prompts to storage |
miniAgent.exportFormat |
Export format: JSON / Markdown / Text |
🧩 Requirements
- VS Code version 1.105.0 or higher
- No API key required
- No external dependencies
- No cost
🐛 Known Issues
🤝 Contributing
We welcome contributions — UI improvements, templates, features, bug fixes.
- Fork the repository
- Create a new branch
- Commit your changes
- Submit a Pull Request
📄 License
This project is licensed under the:
GNU General Public License v3 (GPL v3)
See the full license here → LICENSE.txt
🗓 Release Notes
0.0.1
- Sidebar webview created
- Prompt generator UI added
- Basic template support
📬 Support
If you have feedback, issues, or feature requests:
👉 https://github.com/itsnishant470/mini-agent
⭐ If you find this useful, please star the repository on GitHub!
Made with ❤️ by Nishant Patel
