Antigravity를 설치하면 여러 폴더에 파일이 나뉘어 저장돼요. IDE 본체가 놓이는 애플리케이션 폴더, CLI 실행 파일이 등록되는 바이너리 폴더, 그리고 캐시와 설정이 저장되는 폴더가 각각 다른 역할을 해요. 재설치나 오류 진단을 하려면 이 폴더 구조를 알아두는 게 도움이 돼요.
CLI 바이너리 폴더
맥과 리눅스에서 CLI를 설치하면 기본적으로 ~/.local/bin 폴더 아래에 agy라는 이름의 실행 파일이 생겨요. 이 폴더는 리눅스·유닉스 계열 시스템에서 사용자 개인용 실행 파일을 모아두는 표준 위치라서 다른 CLI 도구들도 흔히 이 경로를 사용해요.
설치 스크립트가 이 경로를 PATH 환경 변수에 자동으로 추가해주기 때문에 새 터미널을 열면 별도 설정 없이 agy 명령이 바로 동작해요. 만약 명령이 인식되지 않는다면 셸 설정 파일에 이 폴더가 PATH로 등록됐는지 확인해봐야 해요.
캐시 폴더
Antigravity는 확장 기능과 임시 데이터를 ~/.config/antigravity/cache 폴더에 저장해요. 이 폴더는 리눅스 표준인 XDG 설정 디렉토리 규칙을 따르는 위치로, 애플리케이션 설정을 ~/.config 아래에 모아두는 방식이에요.
실행이 느려지거나 확장 기능이 오작동할 때 이 캐시 폴더를 통째로 삭제하고 애플리케이션을 재시작하면 문제가 해결되는 경우가 많아요. 캐시를 지워도 로그인 정보나 프로젝트별 설정은 별도로 저장되기 때문에 다시 로그인하거나 설정을 새로 할 필요는 없어요.
IDE 애플리케이션 폴더
Antigravity IDE는 독립 데스크톱 애플리케이션 형태로 설치돼요. 맥에서는 일반적인 macOS 앱과 마찬가지로 Applications 폴더에 놓이고, 윈도우에서는 표준 프로그램 설치 경로에 위치해요. 리눅스에서는 배포판에 따라 /opt나 사용자 홈 디렉토리 하위 폴더에 설치되는 경우가 많아요.
현재 버전인 v2.5.5는 네이티브 창 관리, 통합 에이전트 패널, 실행 워크스페이스를 모두 포함한 완전한 데스크톱 애플리케이션이라 폴더 구조도 일반 IDE와 비슷하게 구성돼 있어요.
폴더 구조 한눈에 보기
- ~/.local/bin/agy – 리눅스·맥에서 CLI 실행 파일이 등록되는 경로예요.
- ~/.config/antigravity/cache – 확장 기능 캐시와 임시 데이터가 저장되는 폴더예요.
- Applications 또는 프로그램 설치 경로 – IDE 본체가 설치되는 운영체제별 표준 애플리케이션 폴더예요.
- 프로젝트 디렉토리 – agy 명령을 실행한 위치를 기준으로 에이전트가 코드베이스를 인식해요.
리눅스 완성 스크립트 폴더 권한 문제
리눅스에서는 설치 스크립트가 셸 완성 기능(tab completion)을 위한 스크립트를 별도 폴더에 등록하는데, 이 파일의 권한이 지나치게 개방적으로 설정되는 경우가 있어요. chmod와 chown 명령으로 권한을 다시 제한해주는 게 안전하다고 안내되고 있어요.
폴더를 완전히 지우고 재설치하는 방법
완전 삭제를 원한다면 CLI 바이너리(~/.local/bin/agy), 캐시 폴더(~/.config/antigravity), IDE 애플리케이션 본체를 순서대로 지워야 흔적이 남지 않아요. 이 중 하나라도 남아있으면 재설치 후에도 이전 설정이나 오류가 그대로 이어질 수 있어요.
Antigravity의 폴더 구조를 정리하면 실행 파일은 ~/.local/bin, 캐시는 ~/.config/antigravity, IDE 본체는 운영체제 표준 애플리케이션 경로에 각각 나뉘어 저장돼요. 오류가 생겼을 때 이 세 폴더를 순서대로 점검하면 원인을 훨씬 빠르게 찾을 수 있어요.