File size: 3,381 Bytes
46562bf |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 |
---
license: mit
---
# gguf-code: IDE AI Coding Assistant
Monster coding agent lives in your IDE - moving beyond a CLI bridge to a fully native IDE AI assistant.
Shipped to [vscode marketplace](https://marketplace.visualstudio.com/items?itemName=gguf.gguf-code) and it's compatible IDEs, i.e., cursor, windsurf, antigravity, etc., [marketplaces](https://open-vsx.org/extension/gguf/gguf-code)
## Features
- **Native Chat Interface**: Deeply integrated webview clean ui for smooth chat interactions inside VS Code (and/or its clone/fork IDEs).
- **Embedded AI Engine**: Run Coder's powerful AI logic directly within the extension process - no external CLI tool required.
- **Project-Aware Context**: Automatically understands your workspace structure and active files.
- **Smart Tools**:
- `read_file`: Intelligently reads file contents with progressive loading for large files.
- `write_file`, `find_files`, and more (Coming Soon).
- **Live Diff Preview**: Preview AI-suggested code changes with standard VS Code diff views.
- **Diagnostics Integration**: Uses LSP diagnostics to help fix errors in your code.
## Requirements
- Visual Studio Code version 1.104.0 or higher
- `coder.config.json` in your workspace root (for configuring AI providers).
## Getting Started
1. **Installation**: Install the extension from the VS Code Marketplace or via `.vsix`.
2. **Configuration**: Ensure you have a `coder.config.json` in your project root (see example below, can be any OpenAI compatible API or local/self-hosted API).
lmstudio (localhost) example:
```json
{
"coder": {
"providers": [
{
"name": "lmstudio",
"models": [
"openai/gpt-oss-20b"
],
"baseUrl": "http://localhost:1234/v1"
}
]
}
}
```
ollama (localhost) example:
```json
{
"coder": {
"providers": [
{
"name": "ollama",
"models": [
"gpt-oss:20b"
],
"baseUrl": "http://localhost:11434/v1"
}
]
}
}
```
fetch from any api provider, see example below:
```json
{
"coder": {
"providers": [
{
"name": "openrouter",
"baseUrl": "https://openrouter.ai/api/v1",
"apiKey": "your-api-key",
"models": ["anthropic/claude-4.5-sonnet"]
}
]
}
}
```
3. **Launch**: Click the "Code" monster icon in the Activity Bar (left sidebar) to open the chat.
## Usage
- **Chat**: Type naturally in the chat window. "Explain this file", "Fix this bug", etc.
- **Context**: The assistant automatically knows about your open files.
## Architecture
This extension has migrated from a thin client (CLI bridge) to a thick client architecture:
- **Frontend**: React + Vite (Webview).
- **Backend**: Node.js Extension Host (running `ai-sdk-client`).
- **Communication**: VS Code Message Passing API.
## Development
```bash
npm install
# Build both Webview and Extension
npm run build
# Watch mode (rebuilds on change)
# Terminal 1:
npm run watch:webview
# Terminal 2:
npm run watch
```
## Contributing
Contributions are welcome!
## License
MIT
|