kdcokenny/opencode-worktree

해결하는 문제

이 프로젝트는 AI 에이전트가 git worktree를 사용하여 격리된 개발 환경을 생성하고 관리할 수 있는 방법을 제공합니다. 작업 트리 생성, 터미널 열기, 특정 디렉터리에서 AI 코드 도구(OpenCode) 시작하는 수작업의 번거로움을 제거하여, 에이전트가 메인 코드베이스를 방해하지 않고 격리된 환경에서 실험할 수 있도록 합니다.

작동 방식

이 플러그인은 OpenCode와 통합되어 worktree_create 및 worktree_delete라는 두 가지 주요 도구를 제공합니다.

1. 생성: AI가 worktree_create를 호출하면, 전용 로컬 디렉터리에 git worktree가 생성되며, 설정 파일 기반으로 필요한 파일(예: .env 파일)이 동기화되고, 디렉터리(예: node_modules)가 심볼릭 링크로 연결됩니다. 생성 후 훅(예: pnpm install)이 실행되고, OpenCode가 실행 중인 새 터미널 창이 자동으로 열립니다.
2. 삭제: AI가 worktree_delete를 호출하면, 삭제 전 훅이 실행되고, worktree 내에서 이루어진 변경 사항이 브랜치에 자동으로 커밋된 후, worktree가 시스템에서 제거됩니다.

macOS, Linux, Windows에서 다양한 터미널 에뮬레이터를 지원하며, 더 프로그래밍 가능한 제어를 위해 tmux 및 cmux와 같은 멀티플렉서도 지원합니다.

대상 사용자

OpenCode를 사용하고 AI 에이전트가 격리된 개발 세션을 자율적으로 관리할 수 있도록 하려는 개발자. 특히 GUI 기반 도구보다 CLI 우선 워크플로우를 선호하는 사용자에게 적합합니다.

주요 특징

• 자동 터미널 생성: 각 새로운 worktree에 대해 새 터미널 창 또는 tmux/cmux 워크스페이스를 자동으로 열립니다.
• 라이프사이클 훅: postCreate 및 postDelete 훅을 지원하여 설정 및 정리 작업을 자동화(예: Docker 컨테이너 시작/정지).
• 파일 동기화: 설정 가능한 파일 및 디렉터리 동기화로 격리된 환경을 사용 가능한 상태로 유지합니다.
• 광범위한 터미널 지원: 모든 주요 운영체제에서 현대적인 터미널 에뮬레이터의 네이티브 지원을 제공합니다.