Ch11. GitHub & IDE 통합

OpenCode는 bash 도구를 통해 Git 명령을 네이티브로 실행하고, IDE 확장으로 에디터와 원활하게 연동됩니다.

Git 통합

OpenCode는 별도의 GitHub 전용 도구 없이 bash 도구로 모든 Git 작업을 수행합니다.

PR 리뷰 자동화 예시

커스텀 커맨드로 PR 리뷰를 자동화할 수 있습니다.

.opencode/commands/review-pr.md:

---
description: PR 변경사항 리뷰
agent: review
---

현재 브랜치의 PR 변경사항을 리뷰해주세요.
!`git diff main...HEAD`
보안, 성능, 코드 품질 관점에서 분석해주세요.

CI/CD 통합

opencode run으로 CI 파이프라인에서 자동 리뷰를 실행할 수 있습니다.

# GitHub Actions 예시
- name: Code Review
  run: opencode run --format json "이 PR의 변경사항을 리뷰해주세요"

IDE 확장

VS Code 계열

VS Code, Cursor, Windsurf, VSCodium — IDE 통합 터미널에서 opencode를 실행하면 확장이 자동 설치됩니다.

ACP (Agent Client Protocol) 확장

v1.2.16+에서 ACP를 지원하며, 추가 IDE에서 OpenCode를 에이전트로 사용할 수 있습니다.

IDE 단축키

GitHub Copilot 프로바이더

GitHub Copilot 구독이 있다면 OpenCode에서 Copilot 모델을 사용할 수 있습니다.

{
  "provider": {
    "github-copilot": {}
  },
  "model": "github-copilot/claude-sonnet-4-5"
}

Git-backed Session Review (v1.3.0+)

v1.3.0부터 커밋되지 않은 변경사항과 브랜치 diff를 세션에서 직접 리뷰할 수 있습니다. Git 상태를 에이전트가 자동으로 인식하여 변경 내용을 분석합니다.

• 스테이징된/안 된 변경사항 직접 리뷰
• 브랜치 간 diff를 세션 컨텍스트로 활용
• PR 리뷰 워크플로우와 자연스럽게 연결

GitLab 통합

@gitlab/opencode-gitlab-plugin 플러그인으로 GitLab Duo 도구를 사용할 수 있습니다.

{
  "plugin": ["@gitlab/opencode-gitlab-plugin"]
}

GitLab Agent Platform (v1.3.0+)

v1.3.0에서 GitLab Agent Platform이 도입되었습니다. 주요 기능:

• 자동 워크플로우 모델 검색: GitLab 프로젝트의 CI/CD 파이프라인과 워크플로우 모델을 자동으로 탐색
• WebSocket 기반 로컬 도구 접근: GitLab 에이전트가 WebSocket을 통해 로컬 개발 환경의 도구에 접근 가능

{
  "plugin": ["@gitlab/opencode-gitlab-plugin"],
  "provider": {
    "gitlab": {
      "options": {
        "baseURL": "https://gitlab.company.com"
      }
    }
  }
}

GitHub App

GitHub App을 설치하면 이슈/PR/리뷰에서 /opencode 또는 /oc로 OpenCode를 호출할 수 있습니다.

opencode github install

지원 이벤트: 이슈/PR 댓글, 리뷰 댓글, 스케줄 트리거, workflow dispatch, 이슈/PR 생성

고급 팁

• 리뷰 전용 에이전트: PR 리뷰는 write: false, bash: deny 읽기 전용 에이전트로 분리
• 멘션 규칙: 팀에서 /opencode 혹은 /oc 호출 규칙을 정해 두면 혼선을 줄입니다
• 토큰 관리: CI/봇 환경의 토큰 권한을 최소화
• IDE 확장 표준화: 팀 .vscode/extensions.json에 OpenCode 확장을 포함

참고 문서

• IDE 확장: https://opencode.ai/docs/ide/
• 프로바이더: https://opencode.ai/docs/providers/
• 플러그인: https://opencode.ai/docs/plugins