QodeAssist — AI coding assistant for Qt Creator

QodeAssist brings a full AI coding workflow to Qt Creator for C++ and QML — smart code completion, multi-panel chat, inline quick refactoring, and project-aware tool calling. It works with local runtimes (Ollama, llama.cpp, LM Studio) and cloud providers (Claude, OpenAI, Google AI, Mistral), can run as an MCP server so other clients reuse its project context, and can also act as an MCP client to consume tools from external MCP servers (authenticated MCP servers are not supported yet).
⚠️ 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
- Overview
- Install Plugin
- Configuration
- Features
- Context Layers
- QtCreator Version Compatibility
- Hotkeys
- Troubleshooting
- Development Progress
- Support the Development
- How to Build
Overview
QodeAssist enhances Qt Creator with AI-powered coding assistance:
- Code Completion — intelligent, context-aware suggestions (FIM and chat models) for C++ and QML, with multiline support
- Chat Assistant — side panel, bottom panel, or detached window; history with auto-save, token monitoring, extended thinking
- Quick Refactoring — inline AI-assisted edits directly in the editor with a searchable custom-instructions library
- Agent Tools — read, search, create and edit files; build the project; run terminal commands; access linter/compiler issues; manage TODOs
- Agent Skills — reusable folders of specialized instructions loaded on demand; discovered from
.qodeassist/skills/ and .claude/skills/, invoked automatically, with /skill, or always-on
- MCP Server — expose QodeAssist's project-aware tools to external MCP clients (Claude Code, VS Code, Claude Desktop via bridge)
- MCP Client Hub — connect QodeAssist to external MCP servers and use their tools in Chat and Quick Refactor (authenticated MCP servers are not supported yet)
- File Context — attach, link, or auto-sync open editor files for richer prompts
- Many Providers — Ollama, llama.cpp, LM Studio (Chat + Responses), Claude, OpenAI (Chat + Responses), Google AI, Mistral, Codestral, OpenRouter, any OpenAI-compatible endpoint
- Customizable — per-project rules (
.qodeassist/rules/), agent roles, reusable refactor templates, full prompt-template control
Join our Discord Community to get support and connect with other users!
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
- Install Latest Qt Creator
- 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
- 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:
- Open QodeAssist Settings
- 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)
- 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:
Local providers:
- Ollama — native Ollama API
- Ollama (OpenAI-compatible) — Ollama's
/v1 endpoint for tool-calling models
- llama.cpp — local
llama-server
- LM Studio — OpenAI-compatible Chat API
- LM Studio (Responses API) — newer models that require the Responses endpoint
Cloud providers:
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