OpenCode 설치 스크립트 추가 및 README 갱신

2026-10-10 08:17:53 +09:00
1 parent ae8397aef4
commit 4e82bde404
@@ -0,0 +1,40 @@
+# OpenCode 설치 스크립트 및 README 갱신 실행 계획
+
+## 1. 개요
+터미널 기반 오픈소스 AI 코딩 에이전트인 **OpenCode**의 설치 스크립트(`install-opencode.sh`, `install-opencode.ps1`)를 생성하고, `README.md`의 "4.4 Pi Coding Agent" 자리에 OpenCode 설명을 배치하며 Pi Coding Agent를 4.5로, Open Code Review를 4.6으로 재정렬합니다.
+
+```mermaid
+flowchart TD
+    A["실행 계획 수립 (IMP-PLAN)"] --> B["install-opencode.sh 생성"]
+    B --> C["install-opencode.ps1 생성"]
+    C --> D["README.md 갱신 (섹션 4.4에 OpenCode 추가 및 번호 재정렬)"]
+    D --> E["동작 검증"]
+    E --> F["단계별 보고서 작성 (PHASE01)"]
+    F --> G["graphify 업데이트"]
+    G --> H["Git 커밋 및 푸시"]
+```
+
+## 2. 단계별 작업 항목
+
+### 1단계: install-opencode.sh 구현
+- [x] 공식 설치 스크립트(`https://opencode.ai/install`) 연동 및 검증
+- [x] `$HOME/.local/bin` 심볼릭 링크 연동 로직 추가
+- [x] 실행 권한 부여(`chmod +x`) 및 로컬 셸 문법 확인
+
+### 2단계: install-opencode.ps1 구현
+- [x] CPU 아키텍처(x64, arm64) 자동 감지 로직 구현
+- [x] GitHub Releases(`anomalyco/opencode`) 최신 바이너리 zip 다운로드
+- [x] `$env:USERPROFILE\.local\bin`에 `opencode.exe` 배포
+- [x] 세션 및 사용자 영구 PATH 등록 로직 구현
+
+### 3단계: README.md 문서 갱신
+- [x] 상단 AI 에이전트 목록에 OpenCode 추가
+- [x] macOS/Linux 설치 가이드에 `install-opencode.sh` 추가
+- [x] Windows 설치 가이드에 `install-opencode.ps1` 추가
+- [x] 상세 사용법 4.4에 OpenCode 추가, 기존 4.4 Pi -> 4.5, 4.5 ocr -> 4.6 번호 재정렬
+
+### 4단계: 사후 처리 및 검증
+- [x] 스크립트 로컬 동작 검증
+- [x] 단계별 보고서(`INSTALL-OPENCODE-PHASE01.md`) 작성
+- [x] graphify 그래프 갱신
+- [x] Git 커밋 및 푸시
@@ -0,0 +1,41 @@
+# 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` 링크 및 마크다운 서식 정합성 확인 완료.