Mi Coder 🤖

VS Code 를 위한 AI 코딩 어시스턴트

Mi Coder 는 VS Code 안에서 동작하는 AI 기반 코딩 어시스턴트입니다. 기본 설정은 Ollama 와 같은 로컬 LLM 을 사용하며, 사용자가 설정한 OpenAI 호환 API 로도 코드를 분석하고, 파일을 수정하며, Git 명령어를 실행하는 등 다양한 개발 작업을 도와줍니다.

✨ 주요 기능

• 🧠 기본 로컬 AI: Ollama 기반 로컬 실행을 기본값으로 제공
• 📁 파일 시스템 조작: 파일을 읽기, 쓰기, 삭제, 검색
• ✏️ 코드 편집: 파일 수정, 코드 완성, 검색 및 교체
• 🔍 코드 탐색: 경량 심볼 네비게이션, 시맨틱 검색
• 📦 Git 통합: 상태 확인, 디프, 커밋, 스태시
• 🏗️ 체크포인트 관리: 작업 상태 저장 및 복원
• 🌐 다양한 모델 지원: Ollama, OpenAI 호환 API 지원

🚀 빠른 시작

1. 설치

VS Code Marketplace 에서 Mi Coder 를 검색하여 설치하세요.

또는 다음 명령어로 수동 설치:

# VSIX 파일 설치
code --install-extension mi-coder-*.vsix

2. 설정

설치 후 다음 설정을 확인하세요:

{
  "mi-coder.provider": "ollama",
  "mi-coder.model": "gemma4:e4b",
  "mi-coder.backendUrl": "http://127.0.0.1:11434",
  "mi-coder.language": "korean"
}

3. 사용

1. VS Code 왼쪽 사이드바의 Mi Coder 아이콘을 클릭
2. 채팅 창에서 작업을 요청하세요!

예시:

• "src/agent.ts 의 주석을 추가해줘"
• "package.json 의 의존성을 업데이트해줘"
• "git commit 메시지를 작성해줘"

📋 설정 항목

🎯 사용 사례

코드 리뷰 및 개선

"src/agent.ts 의 에러 핸들링을 개선해줘"

문서화

"README.md 에 사용 사례 섹션을 추가해줘"

코드 생성

"새로운 React 컴포넌트를 생성해줘"

디버깅

"git diff 로 변경 사항을 확인해줘"

프로젝트 구조 이해

"프로젝트의 주요 디렉토리 구조를 설명해줘"

🔧 개발자용

로컬 개발

npm install
npm run dev

빌드

npm run build
npm run package  # VSIX 생성

유틸리티

npm run watch          # 개발 중 자동 재빌드
npm run check-types    # 타입 체크
npm run clean          # 빌드 결과물 정리

📝 기술적 세부사항

Mi Coder 는 다음 기술을 사용합니다:

• TypeScript - 타입 안전한 코드
• React - 웹뷰 UI
• esbuild - 빠른 빌드
• Ollama - 로컬 LLM

지원되는 도구

• 파일 시스템: read_file, write_file, delete_file, list_directory, search_files
• 에디터: apply_patch, search_replace, insert_text, complete_code
• 검색: grep_search, semantic_search
• 코드 네비게이션: lsp_query, repo_map
• 터미널: run_command
• Git: git_status, git_diff, git_log, git_commit, git_stash
• 체크포인트: create_checkpoint, list_checkpoints, restore_checkpoint
• 파일 히스토리: list_file_history, restore_file_version

🔒 보안 및 데이터 처리

• 기본 제공자(ollama)는 로컬 Ollama 서버로 요청을 보냅니다
• custom 제공자나 원격 backendUrl을 설정하면 프롬프트, 선택한 코드 컨텍스트, 도구 결과가 해당 API 로 전송될 수 있습니다
• OpenAI 호환 API 인증이 필요한 경우 Command Palette 에서 Mi Coder: Set API Key 를 실행하세요
• CLI 또는 자동화 환경에서는 MI_CODER_API_KEY 환경 변수를 사용할 수 있습니다
• 파일 수정, 삭제, 터미널, Git 작업 등 영향이 큰 작업은 승인 모드에서 사용자 확인을 거칩니다

🆘 지원 및 변경 사항

• 문제 신고 및 기능 요청: GitHub Issues
• 변경 이력: CHANGELOG.md
• 지원 안내: SUPPORT.md

🤝 기여

이 프로젝트에 기여하고 싶으시면:

1. Fork 하세요
2. 브랜치 생성 (git checkout -b feature/amazing-feature)
3. 커밋 (git commit -m 'Add some feature')
4. 푸시 (git push origin feature/amazing-feature)
5. Pull Request

📄 라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일 참조

🙏 감사의 말씀

Mi Coder 는 로컬 프라이버시를 중시하는 개발자들을 위해 만들어졌습니다.

VS Code 버전 요구사항: 1.85.0 이상