Community코딩 & 개발github.com

m24927605/ait

AI 코딩 에이전트를 위한 워크트리 격리 및 출처 추적

ait란 무엇인가요?

ait은 AI 코딩 에이전트(예: Claude Code, Cursor, Codex)가 프로젝트 작업 시 발생하는 파일 변경 사항을 격리된 작업 트리(worktree) 내에서 수행하고, 변경 내역의 출처(provenance)를 명확히 추적할 수 있도록 도와주는 도구입니다. 이를 통해 에이전트가 실수로 메인 프로젝트 코드를 오염시키거나, 병렬 작업 간 충돌이 발생하는 것을 방지할 수 있습니다. 각 에이전트 세션마다 독립적인 Git 워크트리를 생성하여 변경 사항을 격리하며, 완료된 작업은 브랜치 단위로 병합하거나 검토할 수 있어 안전한 협업이 가능합니다. 개발자 도구와 AI 에이전트 플랫폼 전반에서 유용하게 사용할 수 있으며, Git 기반 워크플로우에 자연스럽게 통합됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add m24927605/ait

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ait은(는) 무엇을 하나요?

AI 코딩 에이전트를 위한 워크트리 격리 및 출처 추적

개요

ait은 AI 코딩 에이전트가 프로젝트를 수정할 때 안전한 격리 환경을 제공하고, 모든 변경 사항의 출처를 추적할 수 있게 해주는 도구입니다.

주요 기능

  • 워크트리 격리: 각 AI 에이전트 세션마다 독립적인 Git 워크트리를 생성하여 메인 브랜치에 영향을 주지 않음
  • 출처 추적: 변경 사항이 어떤 에이전트 세션에서 발생했는지 자동으로 기록
  • 안전한 병합: 격리된 작업을 브랜치 단위로 검토 및 병합 가능
  • 호환성: Claude Code, Cursor, Codex 등 주요 AI 코딩 에이전트와 호환

사용 방법

  1. 프로젝트 초기화: ait init
  2. 에이전트 세션 시작: ait start — 새 워크트리 생성
  3. 변경 사항 작업: AI 에이전트가 격리된 워크트리 내에서 자유롭게 작업
  4. 작업 검토: ait review — 변경 사항 확인 및 브랜치 생성
  5. 병합: ait merge — 안전하게 메인 프로젝트에 통합

설치

git clone https://github.com/m24927605/ait
cd ait
make install

환경 변수

  • AIT_WORKTREE_DIR: 워크트리 저장 위치 (기본값: .ait/worktrees/)
  • AIT_BRANCH_PREFIX: 브랜치 접두사 (기본값: ait/)
  • AIT_SESSION_TIMEOUT: 세션 타임아웃 (기본값: 3600초)

라이선스

MIT

관련 스킬