agy -p — 안티그래비티 CLI를 헤드리스 모드로 실행하기
구글 안티그래비티 CLI(agy)도 질문 하나를 던지고 답만 받는 방식이 있습니다. 결과 형식, 이어서 묻기, 권한, 실패 처리까지 공식 문서 기준으로 정리했습니다.
안티그래비티 CLI의 실행 명령은 agy 입니다. -p ( --print , --prompt )를 붙이면 질문 하나를 처리하고 끝나는 헤드리스 모드 로 동작합니다.
가장 기본
agy -p "git rebase가 뭔지 한 문장으로 설명해 줘"
답은 표준 출력으로, 오류·진행 상황·권한 안내는 표준 오류로 나옵니다. 그래서 답만 변수에 담을 수 있습니다.
answer=$(agy -p "버전 관리 프로그램 세 개를 쉼표로 나열해 줘")
헤드리스 모드는 저장된 로그인 정보를 씁니다. 처음에는 agy 를 대화형으로 한 번 실행해 로그인해 두세요.
결과 형식
--output-format text : 답 글자만(기본값)
--output-format json : 끝날 때 JSON 하나. status , response , conversation_id , 사용량 등이 들어 있습니다.
--output-format stream-json : 진행 과정을 한 줄씩 JSON으로
agy -p "숫자 7만 답해" --output-format json | jq -r '.status, .response'
--json-schema 를 함께 쓰면 정해진 모양의 답이 structured_output 에 들어갑니다.
이어서 묻기
agy -p "방금 답을 더 자세히 설명해 줘" --continue
agy -p "지금까지 내용을 요약해 줘" --conversation 대화ID
권한
작업 폴더 안의 파일 읽기·쓰기는 자동으로 허용됩니다. 셸 명령처럼 확인이 필요한 일은 헤드리스에서 조용히 거절 되고 실행은 계속됩니다(종료 코드 0). 필요한 것만 ~/.gemini/antigravity-cli/settings.json 의 permissions.allow 에 적어 허락하세요.
{
"permissions": {
"allow": ["command(git)", "command(regex:npm run (build|lint|test))"]
}
}
--dangerously-skip-permissions 는 모든 작업을 허락하므로, 믿을 수 있는 환경에서만 쓰세요.
실패 처리
성공하면 0, 답을 만들지 못하면 0이 아닌 값으로 끝납니다. JSON 형식에서는 status 가 SUCCESS 인지 확인하세요. 오래 걸리는 작업은 --print-timeout 10m 처럼 제한 시간을 정할 수 있습니다.
코딩AI에서 직접 해 본 결과
agy 1.4.3에서 실행했습니다.
agy -p "숫자 7만 답해" --output-format json
→ status: SUCCESS, response: "7"
스크립트에서는 꼭 JSON 형식으로 받아 status를 확인하세요. 권한 거절은 오류가 아니라서 그냥 넘어가기 쉽습니다.