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

[⬅️ 메인 README로 돌아가기](../README.md) | [💻 Windows 가이드 보기](./WIN-05-VIBE-ASSISTANTS.md)

---

## ⚡ 빠른 원클릭 설치 (Bash)

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

* **설치 명령:**
  ```bash
  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 서비스로 연동

```bash
graphify .                                              # 현재 디렉토리의 코드베이스 그래프 빌드/갱신
graphify query "프로젝트의 핵심 구조와 진입점을 설명해줘"   # 지식 그래프 기반 자연어 질의
graphify path "AuthManager" "DatabasePool"              # 두 심볼 간의 연관 호출 관계 경로 추적
graphify explain "WorkerProcess"                        # 특정 클래스/함수 노드의 상세 정보 확인
graphify update .                                       # AST 기반 초고속 증분 업데이트 (무비용)
```

---

### 5.2. [Open Code Review (ocr)](https://github.com/alibaba/open-code-review)
Alibaba에서 개발한 AI 기반 오픈소스 코드 리뷰 자동화 도구입니다. 결정론적 엔지니어링 분석 기법과 LLM 에이전트의 강점을 하이브리드로 결합하여 코드 변경 사항의 컨텍스트를 깊이 있게 추적하고 리뷰 의견을 생성합니다.

* **설치 명령:**
  ```bash
  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)]
```bash
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 기본 사용법]
```bash
ocr review --from main --to feature-branch   # base 브랜치와 head 브랜치 간 변경 사항 리뷰 실행
ocr config list                             # 현재 구성된 설정 목록 확인
```

---

[⬅️ 이전: 4. AI 개발 에이전트](./UNIX-04-AI-AGENTS.md) | [🏠 메인 README로 돌아가기](../README.md)