install-sh/VIBE-WORK/261104/INSTALL-CODIUM-IMP-PLAN.md

VSCodium (codium) 설치 스크립트 및 문서 추가 계획 (INSTALL-CODIUM-IMP-PLAN)

1. 개요

Visual Studio Code(VS Code)의 오픈소스 코드베이스에서 마이크로소프트의 원격 측정(Telemetry)/트래킹 및 불필요한 독점 요소를 완전히 제거하고 **개발에 꼭 필요한 순수 핵심 기능만 남긴 경량 오픈소스 바이너리 에디터 VSCodium (codium)**의 크로스 플랫폼 자동 설치 스크립트(install-codium.sh, install-codium.ps1)를 제작하고 README.md 및 NECESSARY.md 문서에 반영합니다.

flowchart TD
    Start([install-codium 실행]) --> OSCheck{운영체제 감지}
    OSCheck -- macOS --> BrewInstall["Homebrew Cask 설치<br/>(brew install --cask vscodium)<br/>또는 GitHub Release 폴백"]
    OSCheck -- Linux --> LinuxRepo["공식 패키지 저장소 등록 및 설치<br/>APT (Debian/Ubuntu) / DNF·Zypper (RHEL/SUSE) /<br/>Pacman·AUR (Arch) / GitHub Release tarball 폴백"]
    OSCheck -- Windows --> WinInstall["winget install --id VSCodium.VSCodium<br/>또는 GitHub Releases UserSetup.exe<br/>무인 설치(/VERYSILENT) 및 PATH 연결"]
    BrewInstall & LinuxRepo & WinInstall --> CLI["codium CLI 명령어 및 PATH 검증"]
    CLI --> Done([설치 완료])

2. 작업 단계 및 체크리스트

단계 1: 실행 계획 수립

• 작업 계획서(VIBE-WORK/261104/INSTALL-CODIUM-IMP-PLAN.md) 작성

단계 2: Unix / macOS용 install-codium.sh 구현

• macOS: Homebrew를 통한 brew install --cask vscodium 설치 및 /Applications/VSCodium.app/Contents/Resources/app/bin/codium을 ~/.local/bin/codium에 심볼릭 링크 연결
• Linux (Debian/Ubuntu): https://vscodium.com 공식 가이드에 따라 GPG 키(/usr/share/keyrings/vscodium-archive-keyring.gpg) 및 APT 저장소(https://download.vscodium.com/debs) 등록 후 sudo apt-get install -y codium
• Linux (Fedora/RHEL/Rocky/openSUSE): 공식 RPM 저장소(https://download.vscodium.com/rpms/) 및 GPG 키 등록 후 dnf / zypper 설치
• Linux (Arch): yay / paru 등 AUR 헬퍼 또는 Snap/Flatpak/GitHub Releases(VSCodium-linux-<arch>-<ver>.tar.gz) 3단계 방어 폴백 지원
• 실행 권한 부여 및 bash -n 문법 검증

단계 3: Windows용 install-codium.ps1 구현

• 1차: 공식 권장 방식인 winget install -e --id VSCodium.VSCodium 설치 시도
• 2차(폴백): winget이 없거나 실패할 경우 GitHub Releases API(VSCodium/vscodium)에서 아키텍처(x64/arm64)에 맞는 최신 VSCodiumUserSetup-<arch>-<version>.exe 에셋을 다운로드하여 무인 설치(/VERYSILENT /MERGETASKS=!runcode,addcontextmenufiles,addcontextmenufolders,associatewithfiles,addtopath) 수행 (Fallback 버전 1.96.2.24355 내장)
• codium.cmd / codium 경로 확인 및 현재 세션/사용자 PATH 자동 등록

단계 4: README.md 및 NECESSARY.md 문서 업데이트

• README.md의 3. 개발 유틸리티 & 웹 터미널 섹션에 VSCodium (codium) 추가 (VS Code에서 파생되었으나 불필요한 트래킹/독점 요소를 덜어내고 최소한의 핵심 기능만 담은 순수 오픈소스 코드 에디터임을 강조)
• NECESSARY.md의 3. 개발 유틸리티 섹션 및 설치 가이드, 핵심 사용법에 VSCodium (codium) 추가

단계 5: 완료 보고서 작성 및 Graphify 갱신 / Git 푸시

• 완료 보고서(VIBE-WORK/261104/INSTALL-CODIUM-PHASE01.md) 작성
• uv tool run --from graphifyy graphify update . 실행
• Git commit 및 push