Palm1r/QodeAssist

QodeAssist – Qt Creator를 위한 AI 기반 코딩 어시스턴트

무엇인가요 – QodeAssist는 대규모 언어 모델(LLM) 기능을 IDE로 직접 가져오는 Qt Creator 플러그인입니다. AI 기반 코드 완성, 채팅 패널, 인라인 "quick-refactor" 편집, 그리고 모델이 호출할 수 있는 일련의 tools(파일 읽기/쓰기, 빌드, 터미널, 진단 등)를 추가합니다. 이 플러그인은 Ollama, llama.cpp, LM Studio와 같은 로컬 런타임뿐만 아니라 Anthropic Claude, OpenAI, Google Gemini, Mistral/Codestral, Qwen, DeepSeek 및 모든 OpenAI 호환 엔드포인트와 같은 클라우드 API를 포함한 광범위한 제공업체와 함께 작동할 수 있습니다.

주요 기능

• Context-aware code completion (단일 행 및 다중 행) (C++ 및 QML용) (fill-in-the-middle (FIM) 모델과 chat-style 모델 모두 지원)
• Chat assistant (사이드 패널, 하단 패널 또는 분리된 창, 히스토리 유지, 토큰 사용량 표시, 긴 대화의 선택적 요약 기능 포함)
• Quick Refactor – 선택한 코드를 인라인으로 다시 작성하도록 모델을 호출하며, 검색 가능한 사용자 정의 지침 라이브러리를 사용합니다.
• Agent tools – 모델이 파일을 목록화/투영하거나, 파일을 읽고/쓰거나, 빌드를 실행하거나, 셸 명령을 실행하거나, 린터 진단을 가져오거나, TODO 스타일의 작업을 관리할 수 있는 함수를 호출할 수 있습니다.
• Agent Skills – Markdown 기반 지침의 재사용 가능한 폴더(open Agent Skills 사양과 호환)로, 자동으로 로드되거나 /skill을 통해 호출되거나 "always-on"으로 설정할 수 있습니다.
• MCP (Model Context Protocol) server – QodeAssist의 도구를 HTTP/SSE 또는 stdio를 통해 노출하여 다른 MCP 호환 클라이언트(Claude Code, VS Code, Cursor 등)가 동일한 프로젝트 컨텍스트를 재사용할 수 있도록 합니다.
• MCP client hub – 외부 MCP 서버에 연결하여 해당 도구들을 QodeAssist 내부에서 사용할 수 있게 합니다.
• Multi-provider support – 간단한 UI를 통해 로컬 또는 클라우드 모델을 구성합니다. 빠른 설정 프리셋이 가장 인기 있는 서비스들을 커버합니다.
• Customizable prompt composition – 기능별 시스템 프롬프트, 열린 파일 컨텍스트, 선택적 파일 첨부 처리 기능.

설치

1. Extension-registry method (권장) – 사용 중인 Qt Creator 버전과 일치하는 QodeAssist 레지스트리 URL(예: https://github.com/Palm1r/extension-registry/archive/refs/heads/qodeassist.tar.gz)을 Qt Creator → Extensions → Browser를 통해 추가합니다. 동일한 화면에서 설치 및 업데이트를 수행합니다.
2. Manual method – 컴파일된 플러그인 아카이브를 다운로드하여 사용 중인 버전의 Qt Creator 플러그인 디렉토리(예: macOS의 경우 ~/Library/Application Support/QtProject/Qt Creator/plugins/16.0.0/)에 넣은 다음, *Help → About Plugins… → Install Plugin…*을 통해 활성화합니다.

설정

• Quick Setup 드롭다운을 사용하여 프리셋(Claude, OpenAI, Mistral, Google Gemini, Qwen, DeepSeek)을 선택하고 API 키를 입력합니다. 플러그인은 제공업체 URL, 모델 이름, 및 프롬프트 템플릿을 자동으로 채웁니다.
• 로컬 모델의 경우, Ollama, llama.cpp, 또는 LM Studio를 위한 연결된 문서를 참조하여 QodeAssist가 적절한 엔드포인트로 연결되도록 설정합니다.
• 고급 사용자는 제공업체 설정을 수동으로 편집하고, 개별 도구를 활성화/비활성화하며, 전역 또는 프로젝트별 Agent Skills 디렉토리를 추가할 수 있습니다.

사용법

• Code completion – 평소처럼 타이핑합니다. 세 글자 입력 후 힌트가 나타나거나(hint-based mode) 자동 완성 기능이 요청됩니다(automatic mode). 설정된 키(기본값 Space)를 눌러 수락합니다.
• Chat – 채팅 패널을 열고, 쿼리를 입력하고, 파일을/이미지를 첨부하거나 /skillname으로 스킬을 호출합니다. 모델은 대화 중에 read_file 또는 build_project와 같은 도구를 호출할 수 있습니다.
• Quick Refactor – 코드를 선택하고 리팩터링 명령을 트리거하면, 모델은 선택한 지침 템플릿을 기반으로 편집된 코드 스니펫을 반환합니다.
• MCP – Tools → Options → QodeAssist → MCP Server에서 서버를 활성화하여 다른 에디터가 동일한 프로젝트 인식 도구를 사용할 수 있게 하거나, MCP Client 아래에서 외부 MCP 서버를 구성합니다.

프로젝트 상태

• 이 저장소는 archived 상태입니다. 저자는 저작권 고지 분쟁 이후 개발을 중고단했습니다. 마지막 출시 버전은 여전히 다운로드할 수 있지만, 추가적인 업데이트나 버그 수정은 기대할 수 없습니다.

License – GPL v3.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가적인 기능은 추론되지 않았습니다.