QodeAssist - AI-powered coding assistant plugin for Qt Creator

QodeAssist is a comprehensive AI-powered coding assistant plugin for Qt Creator. It provides intelligent code completion, interactive chat with multiple interface options, inline quick refactoring, and AI function calling capabilities for C++ and QML development. Supporting both local providers (Ollama, llama.cpp, LM Studio) and cloud services (Claude, OpenAI, Google AI, Mistral AI), QodeAssist enhances your productivity with context-aware AI assistance, project-specific rules, and extensive customization options directly in your Qt development environment.

⚠️ Important Notice About Paid Providers

When using paid providers like Claude, OpenRouter or OpenAI-compatible services:

• These services will consume API tokens which may result in charges to your account
• The QodeAssist developer bears no responsibility for any charges incurred
• Please carefully review the provider's pricing and your account settings before use

Table of Contents

1. Overview
2. Install Plugin
3. Configuration
4. Features
5. Context Layers
6. QtCreator Version Compatibility
7. Hotkeys
8. Troubleshooting
9. Development Progress
10. Support the Development
11. How to Build

Overview

QodeAssist enhances Qt Creator with AI-powered coding assistance:

• Code Completion: Intelligent, context-aware code suggestions for C++ and QML
• Chat Assistant: Multiple interface options (popup window, side panel, bottom panel)
• Quick Refactoring: Inline AI-assisted code improvements directly in editor with custom instructions library
• File Context: Attach or link files for better AI understanding
• Tool Calling: AI can read project files, search code, and access diagnostics
• Multiple Providers: Support for Ollama, Claude, OpenAI, Google AI, Mistral AI, llama.cpp, and more
• Customizable: Project-specific rules, custom instructions, and extensive model templates

Join our Discord Community to get support and connect with other users!

<details> <summary>Code completion: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/255a52f1-5cc0-4ca3-b05c-c4cf9cdbe25a" width="600" alt="QodeAssistPreview"> </details> <details> <summary>Quick refactor in code: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/4a9092e0-429f-41eb-8723-cbb202fd0a8c" width="600" alt="QodeAssistPreview"> </details> <details> <summary>Multiline Code completion: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/c18dfbd2-8c54-4a7b-90d1-66e3bb51adb0" width="600" alt="QodeAssistPreview"> </details> <details> <summary>Chat with LLM models in side panels: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/ead5a5d9-b40a-4f17-af05-77fa2bcb3a61" width="600" alt="QodeAssistChat"> </details> <details> <summary>Chat with LLM models in bottom panel: (click to expand)</summary> <img width="326" alt="QodeAssistBottomPanel" src="https://github.com/user-attachments/assets/4cc64c23-a294-4df8-9153-39ad6fdab34b"> </details> <details> <summary>Chat in addtional window: (click to expand)</summary> <img width="851" height="865" alt="image" src="https://github.com/user-attachments/assets/a68894b7-886e-4501-a61b-7161ae34b427" /> </details> <details> <summary>Automatic syncing with open editor files: (click to expand)</summary> <img width="600" alt="OpenedDocumentsSync" src="https://github.com/user-attachments/assets/08efda2f-dc4d-44c3-927c-e6a975090d2f"> </details> <details> <summary>Example how tools works: (click to expand)</summary> <img width="600" alt="ToolsDemo" src="https://github.com/user-attachments/assets/cf6273ad-d5c8-47fc-81e6-23d929547f6c"> </details>

Install plugin to QtCreator

Method 1: Using QodeAssistUpdater (Beta)

QodeAssistUpdater is a command-line utility that automates plugin installation and updates with automatic Qt Creator version detection and checksum verification.

Features:

• Automatic Qt Creator version detection
• Install, update, or remove plugin with single command
• List all available plugin versions
• Install specific plugin version
• Checksum verification
• Non-interactive mode for CI/CD

Installation:

Download pre-built binary from QodeAssistUpdater releases or build from source

Usage:

# Check current status and available updates
./qodeassist-updater --status

# Install latest version
./qodeassist-updater --install

For more information, visit the QodeAssistUpdater repository.

Method 2: Manual Installation

1. Install Latest Qt Creator
2. Download the QodeAssist plugin for your Qt Creator
   • Remove old version plugin if already was installed
     • on macOS for QtCreator 16: ~/Library/Application Support/QtProject/Qt Creator/plugins/16.0.0/petrmironychev.qodeassist
     • on windows for QtCreator 16: C:\Users<user>\AppData\Local\QtProject\qtcreator\plugins\16.0.0\petrmironychev.qodeassist\lib\qtcreator\plugins
3. Launch Qt Creator and install the plugin:
   • Go to:
     • MacOS: Qt Creator -> About Plugins...
     • Windows\Linux: Help -> About Plugins...
   • Click on "Install Plugin..."
   • Select the downloaded QodeAssist plugin archive file

Configuration

Quick Setup (Recommended for Beginners)

The Quick Setup feature provides one-click configuration for popular cloud AI models. Get started in 3 easy steps:

<details> <summary>Quick setup: (click to expand)</summary> <img width="600" alt="Quick Setup" src="https://github.com/user-attachments/assets/20df9155-9095-420c-8387-908bd931bcfa"> </details>

1. Open QodeAssist Settings
2. Select a Preset - Choose from the Quick Setup dropdown:
   • Anthropic Claude (Sonnet 4.5, Haiku 4.5, Opus 4.5)
   • OpenAI (gpt-5.2-codex)
   • Mistral AI (Codestral 2501)
   • Google AI (Gemini 2.5 Flash)
3. Configure API Key - Click "Configure API Key" button and enter your API key in Provider Settings

All settings (provider, model, template, URL) are configured automatically. Just add your API key and you're ready to go!

Manual Provider Configuration

For advanced users or local models, choose your preferred provider and follow the detailed configuration guide:

• Ollama - Local LLM provider
• llama.cpp - Local LLM server
• Anthropic Claude - Cloud provider (manual setup)
• OpenAI - Cloud provider (includes Responses API support)
• Mistral AI - Cloud provider
• Google AI - Cloud provider
• LM Studio - Local LLM provider
• OpenAI-compatible - Custom providers (OpenRouter, etc.)

Recommended Models for Best Experience

For optimal coding assistance, we recommend using these top-tier models:

Best for Code Completion & Refactoring:

• Claude 4.5 Haiku or Sonnet (Anthropic)
• GPT-5.1-codex or codex-mini (OpenAI Responses API)
• Codestral (Mistral)

Best for Chat Assistant:

• Claude 4.5 Sonnet (Anthropic) - Outstanding reasoning and natural conversation flow
• GPT-5.1-codex (OpenAI Responses API) - Latest model with advanced capabilities
• Gemini 2.5 or 3.0 (Google AI) - Latest models from Google
• Mistral large (Mistral) - Fast and capable

Local models:

• Qwen3-coder (Qwen) - Best local models

Additional Configuration

• Agent Roles - Create AI personas with specialized system prompts
• Chat Summarization - Compress conversations to save context tokens
• Project Rules - Customize AI behavior for your project
• Ignoring Files - Exclude files from context using .qodeassistignore

Features

Code Completion

• AI-powered intelligent code completion
• Support for C++ and QML
• Context-aware suggestions
• Multiline completions

Completion Trigger Modes

QodeAssist offers two trigger modes for code completion:

Hint-based

• Shows a hint indicator near cursor when you type 3+ characters
• Press Space (or custom key) to request completion
• Best for: Paid APIs (Claude, OpenAI), conscious control
• Benefits: No unexpected API charges, full control over requests, no workflow interruption
• Visual: Clear indicator shows when completion is ready

Automatic(Default)

• Automatically requests completion after typing threshold
• Works immediately without additional keypresses
• Best for: Local models (Ollama, llama.cpp), maximum automation
• Benefits: Hands-free experience, instant suggestions

💡 Tip: Start with Hint-based to avoid unexpected costs. Switch to Automatic if using free local models.

Configure in: Tools → Options → QodeAssist → Code Completion → General Settings

Chat Assistant

• Multi