install-sh/VIBE-WORK/261012/INSTALL-GRAPHIFY-PHASE01.md

Graphify 설치 스크립트 구현 완료 보고서 (INSTALL-GRAPHIFY-PHASE01)

1. 개요

지식 그래프 기반의 코드베이스 분석 및 컨텍스트 이해 도구인 graphify의 크로스 플랫폼 원클릭 설치 스크립트(install-graphify.sh, install-graphify.ps1)를 구현하고, README.md 문서를 개편하여 "5. 바이브 코딩 도우미" 섹션을 신설하였습니다.

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)로 이동하여 바이브 코딩 보조 도구로 체계화
• 상세 사용법 및 명령어 안내 보강