{"id":14964849,"url":"https://github.com/palm1r/qodeassist","last_synced_at":"2026-01-28T11:22:53.298Z","repository":{"id":254989592,"uuid":"848182195","full_name":"Palm1r/QodeAssist","owner":"Palm1r","description":"QodeAssist is an AI-powered coding assistant plugin for Qt Creator","archived":false,"fork":false,"pushed_at":"2025-04-04T20:12:36.000Z","size":776,"stargazers_count":156,"open_issues_count":8,"forks_count":18,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-05T07:01:26.164Z","etag":null,"topics":["ai","autocomplete","claude","claude-ai","codeassist","llm","lmstudio","local","ollama","openai","private","qtcreator"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Palm1r.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"qodeassist","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-08-27T09:36:27.000Z","updated_at":"2025-04-04T20:12:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"c4d5bfec-4767-4140-bff8-9253b94c4b67","html_url":"https://github.com/Palm1r/QodeAssist","commit_stats":{"total_commits":168,"total_committers":2,"mean_commits":84.0,"dds":"0.011904761904761862","last_synced_commit":"35012865c7749bbfb04abb281edcf01255f2b04d"},"previous_names":["palm1r/qodeassist"],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Palm1r%2FQodeAssist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Palm1r%2FQodeAssist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Palm1r%2FQodeAssist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Palm1r%2FQodeAssist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Palm1r","download_url":"https://codeload.github.com/Palm1r/QodeAssist/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299829,"owners_count":20916190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","autocomplete","claude","claude-ai","codeassist","llm","lmstudio","local","ollama","openai","private","qtcreator"],"created_at":"2024-09-24T13:33:51.766Z","updated_at":"2026-01-28T11:22:53.291Z","avatar_url":"https://github.com/Palm1r.png","language":"C++","funding_links":["https://ko-fi.com/qodeassist"],"categories":["Browser-extensions"],"sub_categories":[],"readme":"# QodeAssist - AI-powered coding assistant plugin for Qt Creator\n[![Build plugin](https://github.com/Palm1r/QodeAssist/actions/workflows/build_cmake.yml/badge.svg?branch=main)](https://github.com/Palm1r/QodeAssist/actions/workflows/build_cmake.yml)\n![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/Palm1r/QodeAssist/total?color=41%2C173%2C71)\n![GitHub Tag](https://img.shields.io/github/v/tag/Palm1r/QodeAssist)\n[![](https://dcbadge.limes.pink/api/server/BGMkUsXUgf?style=flat)](https://discord.gg/BGMkUsXUgf)\n\n![qodeassist-icon](https://github.com/user-attachments/assets/dc336712-83cb-440d-8761-8d0a31de898d) 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.\n\n⚠️ **Important Notice About Paid Providers**\n\u003e When using paid providers like Claude, OpenRouter or OpenAI-compatible services:\n\u003e - These services will consume API tokens which may result in charges to your account\n\u003e - The QodeAssist developer bears no responsibility for any charges incurred\n\u003e - Please carefully review the provider's pricing and your account settings before use\n\n## Table of Contents\n1. [Overview](#overview)\n2. [Install Plugin](#install-plugin-to-qtcreator)\n3. [Configuration](#configuration)\n4. [Features](#features)\n5. [Context Layers](#context-layers)\n6. [QtCreator Version Compatibility](#qtcreator-version-compatibility)\n7. [Hotkeys](#hotkeys)\n8. [Troubleshooting](#troubleshooting)\n9. [Development Progress](#development-progress)\n10. [Support the Development](#support-the-development-of-qodeassist)\n11. [How to Build](#how-to-build)\n\n## Overview\n\nQodeAssist enhances Qt Creator with AI-powered coding assistance:\n\n- **Code Completion**: Intelligent, context-aware code suggestions for C++ and QML\n- **Chat Assistant**: Multiple interface options (popup window, side panel, bottom panel)\n- **Quick Refactoring**: Inline AI-assisted code improvements directly in editor with custom instructions library\n- **File Context**: Attach or link files for better AI understanding\n- **Tool Calling**: AI can read project files, search code, and access diagnostics\n- **Multiple Providers**: Support for Ollama, Claude, OpenAI, Google AI, Mistral AI, llama.cpp, and more\n- **Customizable**: Project-specific rules, custom instructions, and extensive model templates\n\n**Join our [Discord Community](https://discord.gg/BGMkUsXUgf)** to get support and connect with other users!\n\n\u003cdetails\u003e\n  \u003csummary\u003eCode completion: (click to expand)\u003c/summary\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/255a52f1-5cc0-4ca3-b05c-c4cf9cdbe25a\" width=\"600\" alt=\"QodeAssistPreview\"\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eQuick refactor in code: (click to expand)\u003c/summary\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/4a9092e0-429f-41eb-8723-cbb202fd0a8c\" width=\"600\" alt=\"QodeAssistPreview\"\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eMultiline Code completion: (click to expand)\u003c/summary\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/c18dfbd2-8c54-4a7b-90d1-66e3bb51adb0\" width=\"600\" alt=\"QodeAssistPreview\"\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eChat with LLM models in side panels: (click to expand)\u003c/summary\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/ead5a5d9-b40a-4f17-af05-77fa2bcb3a61\" width=\"600\" alt=\"QodeAssistChat\"\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eChat with LLM models in bottom panel: (click to expand)\u003c/summary\u003e\n  \u003cimg width=\"326\" alt=\"QodeAssistBottomPanel\" src=\"https://github.com/user-attachments/assets/4cc64c23-a294-4df8-9153-39ad6fdab34b\"\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eChat in addtional window: (click to expand)\u003c/summary\u003e\n  \u003cimg width=\"851\" height=\"865\" alt=\"image\" src=\"https://github.com/user-attachments/assets/a68894b7-886e-4501-a61b-7161ae34b427\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eAutomatic syncing with open editor files: (click to expand)\u003c/summary\u003e\n  \u003cimg width=\"600\" alt=\"OpenedDocumentsSync\" src=\"https://github.com/user-attachments/assets/08efda2f-dc4d-44c3-927c-e6a975090d2f\"\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eExample how tools works: (click to expand)\u003c/summary\u003e\n  \u003cimg width=\"600\" alt=\"ToolsDemo\" src=\"https://github.com/user-attachments/assets/cf6273ad-d5c8-47fc-81e6-23d929547f6c\"\u003e\n\u003c/details\u003e\n\n## Install plugin to QtCreator\n\n### Method 1: Using QodeAssistUpdater (Beta)\n\nQodeAssistUpdater is a command-line utility that automates plugin installation and updates with automatic Qt Creator version detection and checksum verification.\n\n**Features:**\n- Automatic Qt Creator version detection\n- Install, update, or remove plugin with single command\n- List all available plugin versions\n- Install specific plugin version\n- Checksum verification\n- Non-interactive mode for CI/CD\n\n**Installation:**\n\nDownload pre-built binary from [QodeAssistUpdater releases](https://github.com/Palm1r/QodeAssistUpdater/releases) or build from source\n\n**Usage:**\n\n```bash\n# Check current status and available updates\n./qodeassist-updater --status\n\n# Install latest version\n./qodeassist-updater --install\n```\n\nFor more information, visit the [QodeAssistUpdater repository](https://github.com/Palm1r/QodeAssistUpdater).\n\n### Method 2: Manual Installation\n\n1. Install Latest Qt Creator\n2. Download the QodeAssist plugin for your Qt Creator\n   - Remove old version plugin if already was installed\n      - on macOS for QtCreator 16: ~/Library/Application Support/QtProject/Qt Creator/plugins/16.0.0/petrmironychev.qodeassist\n      - on windows for QtCreator 16: C:\\Users\\\u003cuser\u003e\\AppData\\Local\\QtProject\\qtcreator\\plugins\\16.0.0\\petrmironychev.qodeassist\\lib\\qtcreator\\plugins  \n3. Launch Qt Creator and install the plugin:\n   - Go to: \n     - MacOS: Qt Creator -\u003e About Plugins...\n     - Windows\\Linux: Help -\u003e About Plugins...\n   - Click on \"Install Plugin...\"\n   - Select the downloaded QodeAssist plugin archive file\n\n## Configuration\n\n### Quick Setup (Recommended for Beginners)\n\nThe Quick Setup feature provides one-click configuration for popular cloud AI models. Get started in 3 easy steps:\n\u003cdetails\u003e\n  \u003csummary\u003eQuick setup: (click to expand)\u003c/summary\u003e\n  \u003cimg width=\"600\" alt=\"Quick Setup\" src=\"https://github.com/user-attachments/assets/20df9155-9095-420c-8387-908bd931bcfa\"\u003e\n\u003c/details\u003e\n\n1. **Open QodeAssist Settings**\n2. **Select a Preset** - Choose from the Quick Setup dropdown:\n   - **Anthropic Claude** (Sonnet 4.5, Haiku 4.5, Opus 4.5)\n   - **OpenAI** (gpt-5.2-codex)\n   - **Mistral AI** (Codestral 2501)\n   - **Google AI** (Gemini 2.5 Flash)\n3. **Configure API Key** - Click \"Configure API Key\" button and enter your API key in Provider Settings\n\nAll settings (provider, model, template, URL) are configured automatically. Just add your API key and you're ready to go!\n\n### Manual Provider Configuration\n\nFor advanced users or local models, choose your preferred provider and follow the detailed configuration guide:\n\n- **[Ollama](docs/ollama-configuration.md)** - Local LLM provider\n- **[llama.cpp](docs/llamacpp-configuration.md)** - Local LLM server\n- **[Anthropic Claude](docs/claude-configuration.md)** - Cloud provider (manual setup)\n- **[OpenAI](docs/openai-configuration.md)** - Cloud provider (includes Responses API support)\n- **[Mistral AI](docs/mistral-configuration.md)** - Cloud provider\n- **[Google AI](docs/google-ai-configuration.md)** - Cloud provider\n- **LM Studio** - Local LLM provider\n- **OpenAI-compatible** - Custom providers (OpenRouter, etc.)\n\n### Recommended Models for Best Experience\n\nFor optimal coding assistance, we recommend using these top-tier models:\n\n**Best for Code Completion \u0026 Refactoring:**\n- **Claude 4.5 Haiku or Sonnet** (Anthropic)\n- **GPT-5.1-codex or codex-mini** (OpenAI Responses API)\n- **Codestral** (Mistral)\n\n**Best for Chat Assistant:**\n- **Claude 4.5 Sonnet** (Anthropic) - Outstanding reasoning and natural conversation flow\n- **GPT-5.1-codex** (OpenAI Responses API) - Latest model with advanced capabilities\n- **Gemini 2.5 or 3.0** (Google AI) - Latest models from Google\n- **Mistral large** (Mistral) - Fast and capable\n\n**Local models:**\n- **Qwen3-coder** (Qwen) - Best local models\n\n### Additional Configuration\n\n- **[Agent Roles](docs/agent-roles.md)** - Create AI personas with specialized system prompts\n- **[Chat Summarization](docs/chat-summarization.md)** - Compress conversations to save context tokens\n- **[Project Rules](docs/project-rules.md)** - Customize AI behavior for your project\n- **[Ignoring Files](docs/ignoring-files.md)** - Exclude files from context using `.qodeassistignore`\n\n## Features\n\n### Code Completion\n- AI-powered intelligent code completion\n- Support for C++ and QML\n- Context-aware suggestions\n- Multiline completions\n\n#### Completion Trigger Modes\n\nQodeAssist offers two trigger modes for code completion:\n\n**Hint-based**\n- Shows a hint indicator near cursor when you type 3+ characters\n- Press **Space** (or custom key) to request completion\n- **Best for**: Paid APIs (Claude, OpenAI), conscious control\n- **Benefits**: No unexpected API charges, full control over requests, no workflow interruption\n- **Visual**: Clear indicator shows when completion is ready\n\n**Automatic(Default)**\n- Automatically requests completion after typing threshold\n- Works immediately without additional keypresses\n- **Best for**: Local models (Ollama, llama.cpp), maximum automation\n- **Benefits**: Hands-free experience, instant suggestions\n\n💡 **Tip**: Start with Hint-based to avoid unexpected costs. Switch to Automatic if using free local models.\n\nConfigure in: `Tools → Options → QodeAssist → Code Completion → General Settings`\n\n### Chat Assistant\n- Multiple chat panels: side panel, bottom panel, and popup window\n- Chat history with auto-save and restore\n- Token usage monitoring\n- **[Agent Roles](docs/agent-roles.md)** - Switch between AI personas (Developer, Reviewer, custom roles)\n- **[Chat Summarization](docs/chat-summarization.md)** - Compress long conversations into AI-generated summaries\n- **[File Context](docs/file-context.md)** - Attach or link files for better context\n- Automatic syncing with open editor files (optional)\n- Extended thinking mode (Claude, other providers in plan) - Enable deeper reasoning for complex tasks\n\n### Quick Refactoring\n- Inline code refactoring directly in the editor with AI assistance\n- **Custom instructions library** with search and autocomplete\n- Create, edit, and manage reusable refactoring templates\n- Combine base instructions with specific details\n- **[Learn more](docs/quick-refactoring.md)**\n\n### Tools \u0026 Function Calling\n- Read project files\n- List and search in project\n- Access linter/compiler issues\n- Enabled by default (can be disabled)\n\n## Context Layers\n\nQodeAssist uses a flexible prompt composition system that adapts to different contexts. Here's how prompts are constructed for each feature:\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eCode Completion (FIM Models)\u003c/strong\u003e - Codestral, Qwen2.5-Coder, DeepSeek-Coder (click to expand)\u003c/summary\u003e\n\n```\n┌─────────────────────────────────────────────────────────────────────────────┐\n│                         CODE COMPLETION (FIM Models)                        │\n├─────────────────────────────────────────────────────────────────────────────┤\n│  Examples: Codestral, Qwen2.5-Coder, DeepSeek-Coder                        │\n│                                                                              │\n│  1. System Prompt (from Code Completion Settings - FIM variant)            │\n│  2. Project Rules:                                                          │\n│     └─ .qodeassist/rules/completion/*.md                                   │\n│  3. Open Files Context (optional, if enabled):                             │\n│     └─ Currently open editor files                                         │\n│  4. Code Context:                                                           │\n│     ├─ Code before cursor (prefix)                                         │\n│     └─ Code after cursor (suffix)                                          │\n│                                                                              │\n│  Final Prompt: FIM_Template(Prefix: SystemPrompt + Rules + OpenFiles +     │\n│                                     CodeBefore,                             │\n│                             Suffix: CodeAfter)                              │\n└─────────────────────────────────────────────────────────────────────────────┘\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eCode Completion (Non-FIM Models)\u003c/strong\u003e - DeepSeek-Coder-Instruct, Qwen2.5-Coder-Instruct (click to expand)\u003c/summary\u003e\n\n```\n┌─────────────────────────────────────────────────────────────────────────────┐\n│                     CODE COMPLETION (Non-FIM/Chat Models)                   │\n├─────────────────────────────────────────────────────────────────────────────┤\n│  Examples: DeepSeek-Coder-Instruct, Qwen2.5-Coder-Instruct                 │\n│                                                                              │\n│  1. System Prompt (from Code Completion Settings - Non-FIM variant)        │\n│     └─ Includes response formatting instructions                           │\n│  2. Project Rules:                                                          │\n│     └─ .qodeassist/rules/completion/*.md                                   │\n│  3. Open Files Context (optional, if enabled):                             │\n│     └─ Currently open editor files                                         │\n│  4. Code Context:                                                           │\n│     ├─ File information (language, path)                                   │\n│     ├─ Code before cursor                                                  │\n│     ├─ \u003ccursor\u003e marker                                                     │\n│     └─ Code after cursor                                                   │\n│  5. User Message: \"Complete the code at cursor position\"                   │\n│                                                                              │\n│  Final Prompt: [System: SystemPrompt + Rules]                              │\n│                [User: OpenFiles + Context + CompletionRequest]              │\n└─────────────────────────────────────────────────────────────────────────────┘\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eChat Assistant\u003c/strong\u003e - Interactive coding assistant (click to expand)\u003c/summary\u003e\n\n```\n┌─────────────────────────────────────────────────────────────────────────────┐\n│                            CHAT ASSISTANT                                   │\n├─────────────────────────────────────────────────────────────────────────────┤\n│  1. System Prompt (from Chat Assistant Settings)                           │\n│  2. Agent Role (optional, from role selector):                             │\n│     └─ Role-specific system prompt (Developer, Reviewer, custom)           │\n│  3. Project Rules:                                                          │\n│     ├─ .qodeassist/rules/common/*.md                                       │\n│     └─ .qodeassist/rules/chat/*.md                                         │\n│  4. File Context (optional):                                               │\n│     ├─ Attached files (manual)                                             │\n│     ├─ Linked files (persistent)                                           │\n│     └─ Open editor files (if auto-sync enabled)                            │\n│  5. Tool Definitions (if enabled):                                         │\n│     ├─ ReadProjectFileByName                                               │\n│     ├─ ListProjectFiles                                                    │\n│     ├─ SearchInProject                                                     │\n│     └─ GetIssuesList                                                       │\n│  6. Conversation History                                                    │\n│  7. User Message                                                            │\n│                                                                              │\n│  Final Prompt: [System: SystemPrompt + AgentRole + Rules + Tools]          │\n│                [History: Previous messages]                                 │\n│                [User: FileContext + UserMessage]                            │\n└─────────────────────────────────────────────────────────────────────────────┘\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eQuick Refactoring\u003c/strong\u003e - Inline code improvements (click to expand)\u003c/summary\u003e\n\n```\n┌─────────────────────────────────────────────────────────────────────────────┐\n│                         QUICK REFACTORING                                   │\n├─────────────────────────────────────────────────────────────────────────────┤\n│  1. System Prompt (from Quick Refactor Settings)                           │\n│  2. Project Rules:                                                          │\n│     ├─ .qodeassist/rules/common/*.md                                       │\n│     └─ .qodeassist/rules/quickrefactor/*.md                                │\n│  3. Code Context:                                                           │\n│     ├─ File information (language, path)                                   │\n│     ├─ Code before selection (configurable amount)                         │\n│     ├─ \u003cselection_start\u003e marker                                            │\n│     ├─ Selected code (or current line)                                     │\n│     ├─ \u003cselection_end\u003e marker                                              │\n│     ├─ \u003ccursor\u003e marker (position within selection)                         │\n│     └─ Code after selection (configurable amount)                          │\n│  4. Refactor Instruction:                                                   │\n│     ├─ Built-in (e.g., \"Improve Code\", \"Alternative Solution\")             │\n│     ├─ Custom Instruction (from library)                                   │\n│     │  └─ ~/.config/QtProject/qtcreator/qodeassist/                        │\n│     │      quick_refactor/instructions/*.json                              │\n│     └─ Additional Details (optional user input)                            │\n│  5. Tool Definitions (if enabled)                                          │\n│                                                                              │\n│  Final Prompt: [System: SystemPrompt + Rules]                              │\n│                [User: Context + Markers + Instruction + Details]            │\n└─────────────────────────────────────────────────────────────────────────────┘\n```\n\n\u003c/details\u003e\n\n### Key Points\n\n- **Project Rules** are automatically loaded from `.qodeassist/rules/` directory structure\n- **System Prompts** are configured independently for each feature in Settings\n- **Agent Roles** add role-specific prompts on top of the base system prompt (Chat only)\n- **FIM vs Non-FIM models** for code completion use different System Prompts:\n  - FIM models: Direct completion prompt\n  - Non-FIM models: Prompt includes response formatting instructions\n- **Quick Refactor** has its own provider/model configuration, independent from Chat\n- **Custom Instructions** provide reusable templates that can be augmented with specific details\n- **Tool Calling** is available for Chat and Quick Refactor when enabled\n\nSee [Project Rules Documentation](docs/project-rules.md), [Agent Roles Guide](docs/agent-roles.md), and [Quick Refactoring Guide](docs/quick-refactoring.md) for more details.\n\n## QtCreator Version Compatibility\n\n| Qt Creator Version | QodeAssist Version |\n|-------------------|-------------------|\n| 17.0.0+ | 0.6.0 - 0.x.x |\n| 16.0.2 | 0.5.13 - 0.9.6 |\n| 16.0.1 | 0.5.7 - 0.5.13 |\n| 16.0.0 | 0.5.2 - 0.5.6 |\n| 15.0.1 | 0.4.8 - 0.5.1 |\n| 15.0.0 | 0.4.0 - 0.4.7 |\n| 14.0.2 | 0.2.3 - 0.3.x |\n| 14.0.1 | ≤ 0.2.2 |\n\n## Hotkeys\n\nAll hotkeys can be customized in Qt Creator Settings. Default hotkeys:\n\n| Action | macOS | Windows/Linux |\n|--------|-------|--------------|\n| Open chat window | ⌥⌘W | Ctrl+Alt+W |\n| Close chat window | ⌥⌘S | Ctrl+Alt+S |\n| Manual code suggestion | ⌥⌘Q | Ctrl+Alt+Q |\n| Accept full suggestion | Tab | Tab |\n| Accept word | ⌥→ | Alt+→ |\n| Quick refactor | ⌥⌘R | Ctrl+Alt+R |\n    \n## Troubleshooting\n\nHaving issues with QodeAssist? Check our [detailed troubleshooting guide](docs/troubleshooting.md) for:\n\n- Connection issues and provider URLs\n- Model and template compatibility\n- Platform-specific issues (Linux, macOS, Windows)\n- Resetting settings to defaults\n- Common problems and solutions\n\nFor additional support, join our [Discord Community](https://discord.gg/BGMkUsXUgf) or check [GitHub Issues](https://github.com/Palm1r/QodeAssist/issues).\n\n## Development Progress\n\n- [x] Code completion functionality\n- [x] Chat assistant with multiple panels\n- [x] Diff sharing with models\n- [x] Tools/function calling support\n- [x] Project-specific rules\n- [ ] Full project source sharing\n- [ ] Additional provider support\n- [ ] MCP (Model Context Protocol) support\n\n## Support the development of QodeAssist\nIf you find QodeAssist helpful, there are several ways you can support the project:\n\n1. **Report Issues**: If you encounter any bugs or have suggestions for improvements, please [open an issue](https://github.com/Palm1r/qodeassist/issues) on our GitHub repository.\n\n2. **Contribute**: Feel free to submit pull requests with bug fixes or new features.\n\n3. **Spread the Word**: Star our GitHub repository and share QodeAssist with your fellow developers.\n\n4. **Financial Support**: If you'd like to support the development financially, you can make a donation using one of the following:\n   - Bitcoin (BTC): `bc1qndq7f0mpnlya48vk7kugvyqj5w89xrg4wzg68t`\n   - Ethereum (ETH): `0xA5e8c37c94b24e25F9f1f292a01AF55F03099D8D`\n   - Litecoin (LTC): `ltc1qlrxnk30s2pcjchzx4qrxvdjt5gzuervy5mv0vy`\n   - USDT (TRC20): `THdZrE7d6epW6ry98GA3MLXRjha1DjKtUx`\n\nEvery contribution, no matter how small, is greatly appreciated and helps keep the project alive!\n\n## How to Build\n\n### Prerequisites\n- CMake 3.16+\n- C++20 compatible compiler\n- Qt Creator development files\n\n### Build Steps\n\n1. Create a build directory:\n\n```bash\nmkdir build \u0026\u0026 cd build\n```\n\n2. Configure and build:\n\n```bash\ncmake -DCMAKE_PREFIX_PATH=\u003cpath_to_qtcreator\u003e -DCMAKE_BUILD_TYPE=RelWithDebInfo \u003cpath_to_plugin_source\u003e\ncmake --build .\n```\n\n**Path specifications:**\n- `\u003cpath_to_qtcreator\u003e`:\n  - **Windows/Linux**: Qt Creator build directory or combined binary package\n  - **macOS**: `Qt Creator.app/Contents/Resources/`\n- `\u003cpath_to_plugin_source\u003e`: Path to this plugin directory\n\n## For Contributors\n\n### Code Style\n\n- **QML**: Follow [QML Coding Guide](https://github.com/Furkanzmc/QML-Coding-Guide) by @Furkanzmc\n- **C++**: Use `.clang-format` configuration in the project root\n- Run formatting before submitting PRs\n\n### Development Guidelines\n\nFor detailed development guidelines, architecture patterns, and best practices, see the [project workspace rules](.cursor/rules.mdc).\n\n![qodeassist-icon](https://github.com/user-attachments/assets/dc336712-83cb-440d-8761-8d0a31de898d)\n![qodeassist-icon-small](https://github.com/user-attachments/assets/8ec241bf-3186-452e-b8db-8d70543c2f41)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalm1r%2Fqodeassist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpalm1r%2Fqodeassist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalm1r%2Fqodeassist/lists"}