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

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

```mermaid
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` 링크 및 마크다운 서식 정합성 확인 완료.