51 lines
2.5 KiB
Markdown
51 lines
2.5 KiB
Markdown
# Graphify 설치 스크립트 구현 완료 보고서 (INSTALL-GRAPHIFY-PHASE01)
|
|
|
|
## 1. 개요
|
|
지식 그래프 기반의 코드베이스 분석 및 컨텍스트 이해 도구인 `graphify`의 크로스 플랫폼 원클릭 설치 스크립트(`install-graphify.sh`, `install-graphify.ps1`)를 구현하고, `README.md` 문서를 개편하여 "5. 바이브 코딩 도우미" 섹션을 신설하였습니다.
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
subgraph Prerequisites[사전 요구사항]
|
|
UV["uv 확인 (없으면 안내 후 종료)"]
|
|
end
|
|
|
|
subgraph Install[설치]
|
|
UV --> Graphify["uv tool install 'graphifyy[pdf,openai,anthropic,gemini]'"]
|
|
end
|
|
|
|
subgraph Integrations[에이전트 및 MCP 연동]
|
|
Graphify --> Agents["graphify {antigravity,claude,codex,opencode} install"]
|
|
Graphify --> GeminiMCP["~/.gemini/antigravity/mcp_config.json 구성"]
|
|
end
|
|
|
|
subgraph Assistants[바이브 코딩 도우미]
|
|
Agents --> Section5["README.md 5장: graphify (5.1) & ocr (5.2)"]
|
|
GeminiMCP --> Section5
|
|
end
|
|
```
|
|
|
|
## 2. 세부 구현 내역
|
|
|
|
### 2.1. Unix/macOS용 설치 스크립트 (`install-graphify.sh`)
|
|
- `uv` 설치 여부 점검 (`command -v uv`), 미설치 시 친절한 설치 안내 메시지 및 에러 종료 처리
|
|
- `uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]'` 실행으로 추가 옵션 포함 설치
|
|
- 4대 주요 바이브 코딩 에이전트 연동:
|
|
- `graphify antigravity install`
|
|
- `graphify claude install`
|
|
- `graphify codex install`
|
|
- `graphify opencode install`
|
|
- `~/.gemini/antigravity/mcp_config.json` 자동 구성:
|
|
- `mcpServers.graphify` 또는 루트 레벨 `"graphify"` 엔트리로 안전하게 병합 및 저장
|
|
|
|
### 2.2. Windows PowerShell용 설치 스크립트 (`install-graphify.ps1`)
|
|
- `Get-Command uv`를 통해 `uv` 설치 여부 확인 및 안내
|
|
- `uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]'` 실행
|
|
- 각 에이전트 연동 명령 실행 및 에러 허용 처리
|
|
- `$env:USERPROFILE\.gemini\antigravity\mcp_config.json`을 읽고 파싱하여 JSON 형태로 안전하게 생성/갱신
|
|
|
|
### 2.3. 문서 개편 (`README.md`)
|
|
- 최상단 카테고리에 `5. 바이브 코딩 도우미 (Vibe Coding Assistants)` 신설
|
|
- 5.1로 `graphify` 등록 및 원클릭 설치 명령어(Bash, PowerShell, CMD) 추가
|
|
- 4장에 있던 `Open Code Review (ocr)`를 5장 하위(5.2)로 이동하여 바이브 코딩 보조 도구로 체계화
|
|
- 상세 사용법 및 명령어 안내 보강
|