Ameck Copilot for VS Code 🤖

AI-powered coding assistant with chat, code analysis, and code generation - powered by FREE Groq API.

✨ Features

🚀 Lightning Fast - Powered by Groq's ultra-fast inference
💰 Completely FREE - Uses Groq's free tier (Llama 3.3 70B)
🎨 Beautiful UI - Modern, responsive chat interface in the sidebar
💬 Chat Interface - Natural conversation with context awareness
🔍 Code Analysis - Explain, review, optimize, fix, and document code
⚡ Code Generation - Generate code from natural language descriptions
🔄 Multiple Models - Choose from various free models
📝 Streaming Responses - See responses as they're generated

🚀 Quick Start

1. Get your FREE Groq API key

Visit console.groq.com/keys
Sign up for a free account
Create a new API key

2. Set up the extension

Open VS Code
Click on the Ameck Copilot icon in the Activity Bar (left sidebar)
Click "Set API Key" and enter your Groq API key

3. Start chatting!

Type your question in the chat input
Select code and right-click for code analysis options
Use quick actions or type naturally

📖 Usage

Chat

Have natural conversations about code. Ask questions, get explanations, and receive coding help.

Code Analysis

Select code in the editor, right-click, and choose from:

Explain - Get detailed explanations of code
Review - Get code quality feedback
Optimize - Get performance improvements
Fix - Identify and fix bugs
Document - Add documentation
Test - Generate unit tests

Commands

Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and search for:

Ameck Copilot: Set Groq API Key - Configure your API key
Ameck Copilot: New Chat - Start a new conversation
Ameck Copilot: Explain Code - Explain selected code
Ameck Copilot: Review Code - Review selected code
Ameck Copilot: Optimize Code - Optimize selected code
Ameck Copilot: Fix Code - Fix bugs in selected code
Ameck Copilot: Document Code - Add documentation
Ameck Copilot: Generate Tests - Generate unit tests

⚙️ Configuration

Open Settings (Ctrl+, / Cmd+,) and search for "Ameck Copilot":

Setting	Description	Default
`ameck-copilot.model`	AI model to use	`llama-3.3-70b-versatile`
`ameck-copilot.maxTokens`	Maximum response tokens	`4096`
`ameck-copilot.temperature`	Response creativity (0-2)	`0.7`

🤖 Available Models

Model	Description
Llama 3.3 70B	Best all-around (default)
Llama 3.1 8B	Fast & lightweight
Llama 3.2 90B Vision	Vision capabilities
Llama 4 Scout 17B	Latest Llama 4
Qwen QwQ 32B	Alibaba's model
DeepSeek R1 70B	DeepSeek's model

🛠️ Development

Prerequisites

Node.js 18+
VS Code 1.85+

Setup

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode
npm run watch

Running the Extension

Press F5 to open a new VS Code window with the extension loaded
Find the Ameck Copilot icon in the Activity Bar
Start using the extension!

Building

# Package the extension
npm run package

# Create .vsix file
npx @vscode/vsce package

📁 Project Structure

ameck-copilot-vscode/
├── src/
│   ├── extension.ts          # Extension entry point
│   ├── chatViewProvider.ts   # Webview provider for chat
│   ├── groqService.ts        # Groq API integration
│   └── webviewContent.ts     # Chat UI HTML/CSS/JS
├── media/
│   └── icon.svg              # Extension icon
├── .vscode/
│   ├── launch.json           # Debug configuration
│   └── tasks.json            # Build tasks
├── package.json              # Extension manifest
├── tsconfig.json             # TypeScript configuration
└── README.md

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Groq - For providing free, fast AI inference
Meta - For Llama models

Made with ❤️ by Ameck

Based on the ameck-copilot Python package.