오픈소스 AI 코딩 에이전트 Antigravity 둘러보기와 실무 도입 주의점
오픈소스 AI 코딩 에이전트 Antigravity의 설치 방식, build와 plan 에이전트 모드 구조, 환경 경로 우선순위 및 라이선스 상표 주의사항을 정리합니다.
개발 현장에서 인공지능 기반 코딩 에이전트를 도입할 때 가장 핵심적인 기준은 변경 통제권과 실행 환경의 투명성입니다. anomalyco의 오픈소스 프로젝트 Antigravity는 MIT 라이선스 기반으로 배포되는 AI 코딩 에이전트로, CLI 도구와 베타 데스크톱 애플리케이션 형태로 개발자 환경에 결합됩니다. 공식 저장소에 명시된 아키텍처와 설치 경로, 동작 분리 방식을 면밀히 검토해 실무 적용 시 고려해야 할 기술적 특성과 주의사항을 살펴봅니다.
에이전트 분리와 안전한 코드 탐색 모델
Antigravity는 작업 성격에 따라 성격이 다른 두 가지 기본 에이전트를 제공하며, 사용자는 Tab 키를 통해 손쉽게 전환할 수 있습니다. 기본 동작 모드인 build 에이전트는 파일 편집 및 셸 명령 실행 권한을 온전히 갖추고 실제 소프트웨어 구현과 수정을 수행합니다. 반면 plan 에이전트는 읽기 전용으로 동작하도록 설계되어 기본적으로 파일 편집을 거부하며, 셸 명령 실행 전 반드시 사용자의 사전 승인을 요청합니다. 낯선 대규모 코드베이스를 분석하거나 수정 계획을 수립할 때 실수로 인한 코드 훼손이나 예상치 못한 스크립트 실행 위험을 줄여줍니다. 또한 복잡한 탐색과 다단계 작업을 지원하는 보조 서브에이전트인 general이 내장되어 있어, 대화 입력창에서 @general 멘션을 통해 호출할 수 있습니다.
다양한 배포 채널과 바이너리 설치 경로 규칙
Antigravity는 단일 셸 스크립트 파이프 설치뿐 아니라 npm, bun, pnpm, yarn, Homebrew(anomalyco/tap/antigravity-v2 공식 탭 및 메인 brew), pacman, paru(AUR 베타), mise, nix 등 폭넓은 패키지 관리자를 공식 지원합니다. 아울러 macOS(Apple Silicon/Intel), Windows(x64), Linux(deb, rpm, AppImage)용 데스크톱 앱 베타 빌드도 함께 제공됩니다. 설치 셸 스크립트 사용 시 바이너리 설치 위치는 4단계 우선순위에 따라 결정됩니다. 최우선적으로 $OPENCODE_INSTALL_DIR 환경 변수가 지정한 경로를 따르며, 그 다음으로 XDG 기본 디렉터리 규격을 준수하는 $XDG_BIN_DIR, 사용자 계정 표준 바이너리 폴더인 $HOME/bin, 마지막 기본 폴더인 $HOME/.antigravity/bin 순으로 탐색 및 설치됩니다. 0.1.x 이전의 구버전을 사용하던 환경이라면 설치 전 반드시 기존 버전을 수동 삭제해야 충돌을 방지할 수 있습니다.
생태계 프로젝트 구축 시 브랜드 표기 주의사항
Antigravity는 MIT 라이선스로 소스 코드가 공개되어 자유로운 수정과 배포가 가능하지만, 저장소 관리자는 명확한 상표 및 명칭 정책을 안내하고 있습니다. 프로젝트 이름을 활용해 파생 도구나 연계 확장 프로그램을 개발할 때 이름에 antigravity를 포함하는 경우(예: antigravity-dashboard, antigravity-mobile 등), 공식 프로젝트 팀이 개발한 것이 아니며 공식 팀과 제휴 관계가 없음을 리드미 문서에 명시하도록 규정하고 있습니다. 오픈소스 생태계에서 프로젝트 명칭으로 인한 사용자 혼선을 방지하기 위한 안전장치이므로 연계 도구를 제작할 때 반드시 준수해야 합니다.