Files
install-sh/DOCS/UNIX-05-VIBE-ASSISTANTS.md
T

4.3 KiB

🧠 [macOS / Linux] 5. 바이브 코딩 도우미 (Vibe Coding Assistants)

⬅️ 메인 README로 돌아가기 | 💻 Windows 가이드 보기


⚡ 빠른 원클릭 설치 (Bash)

# 5.1. graphify (코드베이스 지식 그래프 분석기 — 사전 요구사항: uv)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.sh?ref_type=heads" | bash

# 5.2. Open Code Review (ocr — AI 기반 오픈소스 코드 리뷰 자동화 도구)
curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.sh?ref_type=heads" | bash

📖 도구별 상세 사용법 및 팁

5.1. graphify

코드베이스, 문서, 아키텍처를 지식 그래프(Knowledge Graph)로 구조화하여 AI 에이전트가 방대한 코드베이스를 단번에 파악하고 질문에 정밀하게 답변할 수 있도록 돕는 지식 그래프 분석 엔진입니다. Antigravity, Claude Code, Codex, OpenCode 등 다양한 바이브 코딩 에이전트와 매끄럽게 연동되며 Gemini MCP 서버를 지원합니다.

  • 설치 명령:

    curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-graphify.sh?ref_type=heads" | bash
    

    💡 사전 요구사항: Python 패키지 관리자 uv가 먼저 설치되어 있어야 합니다. (curl -LsSf https://astral.sh/uv/install.sh | sh)

  • 주요 특징:

    • 다차원 지식 그래프 구축 — AST 구문 분석과 시맨틱 요약을 통해 함수, 클래스, 모듈 간의 호출 및 상속 관계를 시각적 그래프로 인덱싱
    • 자연어 질의(Query) & 경로 탐색(Path) — 코드베이스에 대한 질문을 던지면 관련 서브그래프를 추출하고, 두 심볼 간의 최단 호출 경로 추적
    • 원클릭 에이전트 연동 — graphify antigravity/claude/codex/opencode install 명령어로 에이전트 규칙 및 MCP 환경 자동 셋업
    • Gemini MCP 연동 — ~/.gemini/antigravity/mcp_config.json을 통해 실시간 MCP 서비스로 연동
graphify .                                              # 현재 디렉토리의 코드베이스 그래프 빌드/갱신
graphify query "프로젝트의 핵심 구조와 진입점을 설명해줘"   # 지식 그래프 기반 자연어 질의
graphify path "AuthManager" "DatabasePool"              # 두 심볼 간의 연관 호출 관계 경로 추적
graphify explain "WorkerProcess"                        # 특정 클래스/함수 노드의 상세 정보 확인
graphify update .                                       # AST 기반 초고속 증분 업데이트 (무비용)

5.2. Open Code Review (ocr)

Alibaba에서 개발한 AI 기반 오픈소스 코드 리뷰 자동화 도구입니다. 결정론적 엔지니어링 분석 기법과 LLM 에이전트의 강점을 하이브리드로 결합하여 코드 변경 사항의 컨텍스트를 깊이 있게 추적하고 리뷰 의견을 생성합니다.

  • 설치 명령:
    curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ocr.sh?ref_type=heads" | bash
    
  • 주요 특징:
    • 엔지니어링 & 에이전트 하이브리드 — 정밀한 파일 필터링과 라인 매칭 기술로 위치 오류(Position drift)를 차단하고, LLM 에이전트가 코드의 시맨틱 영역을 입체적으로 탐색
    • 풍부한 컨텍스트 인지 — 단순한 diff 분석에 머물지 않고 전체 소스코드 검색, 연관 파일 분석 등을 병행
    • CI/CD 통합 지원 — GitHub Actions, GitLab CI 등 빌드 파이프라인에 이식하여 PR 발생 시 자동 코드 리뷰 연동 가능

[사용을 위한 LLM 설정 (예: OpenAI)]

ocr config set llm.url "https://api.openai.com/v1"
ocr config set llm.auth_token "YOUR_API_KEY"
ocr config set llm.model "gpt-4o"

[ocr 기본 사용법]

ocr review --from main --to feature-branch   # base 브랜치와 head 브랜치 간 변경 사항 리뷰 실행
ocr config list                             # 현재 구성된 설정 목록 확인

⬅️ 이전: 4. AI 개발 에이전트 | 🏠 메인 README로 돌아가기