install-sh/VIBE-WORK/261010/INSTALL-OPENCODE-PHASE01.md

OpenCode 설치 스크립트 구축 및 문서 반영 완료 보고서 (PHASE01)

1. 개요

오픈소스 AI 코딩 에이전트인 OpenCode를 macOS, Linux 및 Windows 환경에서 손쉽게 설치할 수 있도록 원클릭 설치 스크립트(install-opencode.sh, install-opencode.ps1)를 구축하고, README.md 가이드에 OpenCode를 추가하며 기존 도구(Pi Coding Agent, Open Code Review)의 번호를 순서대로 재정렬하였습니다.

flowchart LR
    A["OpenCode 설치 스크립트 제작"] --> B["install-opencode.sh (macOS/Linux)"]
    A --> C["install-opencode.ps1 (Windows)"]
    B --> D["README.md 동기화"]
    C --> D
    D --> E["4.4 OpenCode 추가"]
    D --> F["4.5 Pi Coding Agent 재배치"]
    D --> G["4.6 Open Code Review 재배치"]

2. 주요 작업 내역

1) install-opencode.sh (macOS / Linux)

• 공식 설치 인스톨러 연동: curl -fsSL https://opencode.ai/install | bash를 안전하게 실행.
• PATH 및 바이너리 연동: 설치 완료 후 ~/.opencode/bin/opencode 바이너리가 존재할 경우, 본 저장소의 표준 바이너리 경로인 ~/.local/bin/opencode로 심볼릭 링크를 자동 연결.
• 실행 권한 부여: chmod +x install-opencode.sh 적용 및 구문 유효성 검증 완료.

2) install-opencode.ps1 (Windows PowerShell)

• CPU 아키텍처 자동 판별: AMD64/x64 및 ARM64 환경을 자동 감지하여 적합한 zip 아카이브(opencode-windows-x64.zip / opencode-windows-arm64.zip) 타겟팅.
• GitHub Releases 연동 및 Fallback: anomalyco/opencode 최신 릴리스 API를 호출하여 자산을 자동 매칭하며, 네트워크 제한 시 안전한 Fallback 버전 제공.
• 바이너리 추출 및 배포: $env:USERPROFILE\.local\bin에 opencode.exe 자동 압축 해제 및 배치.
• PATH 환경 변수 자동 반영: 현재 세션 $env:Path 즉시 등록 및 Windows 사용자 레지스트리(User PATH) 영구 등록.

3) README.md 개정

• 상단 카테고리 목록: ### 🤖 4. AI 개발 에이전트 목록에 OpenCode 항목 추가.
• macOS / Linux 설치 섹션: install-opencode.sh 원격 실행 원라이너 추가.
• Windows 설치 섹션: CMD 및 PowerShell 각각에서 실행 가능한 install-opencode.ps1 원라이너 추가.
• 도구별 상세 사용법 재정렬:
  • #### 4.4. OpenCode 신규 작성 (개요, 특징, TUI 기본 명령어)
  • #### 4.5. Pi Coding Agent (기존 4.4에서 4.5로 순번 변경)
  • #### 4.6. Open Code Review (기존 4.5에서 4.6으로 순번 변경)

3. 결과 검증

• Bash 문법 검증: bash -n install-opencode.sh 통과.
• README.md 링크 및 마크다운 서식 정합성 확인 완료.