kdcokenny/opencode-worktree

해결하는 문제

격리된 개발 환경을 수동으로 설정하는 번거로움을 없애줍니다. git worktree를 수동으로 생성하고, 터미널을 열고, 디렉토리로 이동하여 AI 코딩 도구를 시작하는 대신, 이 플러그인은 AI 기반 개발의 전체 수명 주기를 자동화합니다.

작동 방식

이 플러그인은 AI 에이전트가 호출할 수 있는 두 가지 주요 도구를 제공합니다.

1. worktree_create: 전용 로컬 디렉토리에 git worktree를 자동으로 생성하고, 새 터미널 창을 띄우며(macOS, Linux, Windows의 다양한 터미널 지원), 해당 세션 내에서 OpenCode를 실행합니다.
2. worktree_delete: 보류 중인 변경 사항을 자동으로 커밋하고 git worktree를 제거하여 환경을 정리합니다.

.opencode/worktree.jsonc를 통한 설정을 지원하여 파일 동기화(.env 파일 복사 또는 node_modules 심볼릭 링크) 및 수명 주기 훅(생성 후 pnpm install 실행 또는 삭제 전 docker compose down 실행)을 처리할 수 있습니다.

대상 사용자

수동 컨텍스트 전환이나 정리 작업 없이 격리된 개발 세션을 원활하게 생성하고 관리해야 하는 CLI 우선 개발자 및 AI 에이전트.

주요 특징

• 자동 터미널 실행: 호환되는 터미널(Ghostty, iTerm2, Kitty, Windows Terminal 등)을 감지하여 열거나 tmux 및 cmux와 같은 멀티플렉서와 통합합니다.
• 마찰 없는 격리: AI 에이전트가 메인 작업 공간에 영향을 주지 않고 격리된 브랜치에서 실험할 수 있도록 합니다.
• 사용자 정의 가능한 수명 주기: 환경 설정 및 해제를 위해 삭제 전/생성 후 훅을 지원합니다.
• 통합 파일 동기화: 메인 프로젝트와 worktree 간에 필요한 설정 파일 및 디렉토리 전송을 자동으로 처리합니다.