Antigravity CLI 명령·설정 레퍼런스

이 페이지의 목차

쉽게 말하면

Antigravity CLI(agy)의 설정 파일 ~/.gemini/antigravity-cli/settings.json에 넣는 키(설정 항목), 그 밖의 설정 파일 위치, 입력창에서 /로 부르는 명령, 기본 단축키, 실행할 때 붙이는 플래그를 한 곳에 모은 찾아보기 페이지다. 처음이라면 입력창에 /만 쳐서 명령 목록을 보거나 /help를 연다. 대부분의 키는 /config 메뉴에서 바꿀 수 있어 파일을 직접 고칠 일은 많지 않다. 권한 키(agentMode, toolPermission)와 --dangerously-skip-permissions 플래그는 에이전트가 묻지 않고 할 수 있는 일을 넓히므로 조건을 함께 읽는다: 예컨대 auto는 Preview이고 business·enterprise 계정은 쓸 수 없으며, v1.4.4부터는 기기에서 샌드박스를 쓸 수 없으면 샌드박스 설정은 효과가 없다(자세한 조건은 아래 "1. 안전·권한"·"실행 플래그" 절).

근거 Antigravity CLI 설정 문서 Antigravity CLI 명령 레퍼런스

확인 2026-10-29근거 자료 2건갱신 2026-10-29언급 13곳

이 페이지의 목차

확인 날짜 안내

Antigravity 공식 Settings 문서 CLI 절(Antigravity CLI 설정 문서)과 CLI commands 문서(Antigravity CLI 명령 레퍼런스) 기준이다(둘 다 원본 날짜 미상, 수집 2026-10-29). 두 문서의 설정 키 이름·기본값은 서로 맞는다. 키 이름·기본값·버전 조건은 원본 표기를 그대로 옮겼다. 몇 주 단위로 바뀔 수 있으므로 대외 자료에 옮기기 전에 공식 문서를 다시 확인한다.

Antigravity CLI의 설정 키를 주제별 표로 모은다. 설정을 실제로 바꾸고 확인하는 순서는 Antigravity CLI 설정 바꾸기·확인·문제 해결에 있다.

설정 파일 위치 (2026-10-29 기준)#

무엇	위치	여는·관리하는 명령
일반 설정	`~/.gemini/antigravity-cli/settings.json`	`/config`(별칭 `/settings`)
단축키	`~/.gemini/antigravity-cli/keybindings.json`	`/keybindings`
훅	전역 `~/.gemini/config/hooks.json`, 워크스페이스 `<workspace>/.agents/hooks.json`	`/hooks`(새 훅은 전역 파일에 저장)
MCP 서버	전역 `~/.gemini/config/mcp_config.json`, 워크스페이스 `<workspace>/.agents/mcp_config.json`	`/mcp`(전역)
플러그인	`~/.gemini/config/plugins/<plugin>/`, 워크스페이스 `<workspace>/.agents/plugins/<plugin>/`. 플러그인마다 `plugin.json` 매니페스트를 둘 수 있다	—

근거: Antigravity CLI 설정 문서. 훅을 settings.json 안에서도 읽는지는 다른 공식 문서와 말이 달랐는데 이 문서 기준(읽지 않는다)으로 정리했고, 플러그인 경로는 상충으로 남겼다. 둘 다 Antigravity CLI의 "설정 파일" 절에 있다.

settings.json을 읽고 저장하는 규칙(원본 요약): 기본값과 다른 값만 저장하고, 시작할 때 파일을 CLI 형식으로 다시 쓰며 기본값인 키를 지운다. 모르는 키($schema 등)는 무시하되 남긴다. 파일은 내 사용자만 읽을 수 있게(0600) 저장한다. 타입이 틀리거나 JSON이 깨지면 세션 전에 Settings Error 화면이 뜬다. Antigravity CLI 설정 문서

설정 키 (2026-10-29 기준)#

표의 "/config 이름"이 "—"인 키는 settings.json에서만 바꿀 수 있다. 근거는 Antigravity CLI 설정 문서이고, CLI commands 문서의 키 표(Antigravity CLI 명령 레퍼런스)가 같은 키·기본값에 타입(string·boolean·integer·object)을 더해 확인한다.

1. 안전·권한#

키	`/config` 이름	기본값	하는 일·조건
`agentMode`	Agent Mode	`default`(키를 두지 않음)	세션 실행 모드. `default`: 파일을 만들거나 고치기 전에 diff 검토를 묻는다. `accept-edits`: 워크스페이스 파일 편집·생성을 자동 승인. `auto`(Preview): 파일 편집을 자동 승인하고, 터미널 명령은 기본으로 터미널 샌드박스 안에서 돌리며, 샌드박스 밖에서 돌아야 하는 명령은 자동으로 평가해 안전하고 되돌릴 수 있는 것은 묻지 않고, 위험하거나 되돌릴 수 없는 것은 승인을 기다린다. `plan`: `/plan`을 앞에 붙여 편집 전에 계획부터 세운다. 세션마다 `--mode`로 바꾸거나 Shift+Tab으로 돌릴 수 있다
`toolPermission`	Tool Permission	`request-review`	도구를 쓰기 전에 언제 묻는지. `request-review`: 쓰기·bash·웹·MCP 도구 전에 묻는다(allow 규칙이 덮는 동작은 예외). `proceed-in-sandbox`: Sandbox Mode가 켜져 있고 명령이 샌드박스 안에서 돌 때만 묻지 않고, 아니면 묻는다. `strict`: 파일 읽기까지 모든 도구 동작 전에 묻는다(allow 규칙이 맞아도, `auto` 모드보다 앞선다). `always-proceed`: 터미널 명령·웹 요청·MCP 도구를 묻지 않고 돌린다(ask·deny 규칙에 맞는 동작은 예외, 원본 표현 "highest risk, use with caution", `auto` 모드보다 앞선다). 어느 모드에서도 `permissions`의 deny 규칙은 동작을 막는다
`artifactReviewPolicy`	Artifact Review	`asks-for-review`	구현 계획 같은 아티팩트에 의견을 구할 때 멈춰 기다리는지. `asks-for-review`(항상 기다림), `agent-decides`(지금은 `asks-for-review`와 같음), `always-proceed`(기다리지 않음). 파일 편집에는 영향이 없다(그건 Agent Mode가 정함)
`enableTerminalSandbox`	Sandbox Mode	꺼짐	켜면 에이전트가 띄우는 모든 터미널 명령을 운영체제 컨테이너 안으로 제한한다. `agentMode`가 `auto`면 자동으로 켜진다
`allowNonWorkspaceAccess`	Non-Workspace Access	꺼짐	켜면 워크스페이스 폴더 밖 파일을 읽고 고칠 수 있다. 이때도 Tool Permission, Agent Mode, 권한 규칙을 따른다. 원본은 안전을 위해 기본으로 꺼 둔다고 적는다

조건(원본 Note): auto 모드는 macOS·Linux에서 v1.3.5+, Windows에서 v1.4.4+에 있고, business·enterprise 계정은 쓸 수 없다. auto를 쓸 수 없는 곳에서 agentMode를 auto로 두면 default 모드로 시작한다. v1.4.4부터 기기에서 샌드박스를 쓸 수 없으면(예: Windows 10, 이전 Windows 11 빌드, 권한 없는 사용자 네임스페이스를 막는 Linux 호스트와 일부 컨테이너) Sandbox Mode는 효과가 없고, /config는 Sandbox Mode·proceed-in-sandbox·auto를 숨기며, 저장된 proceed-in-sandbox는 request-review처럼 동작한다. Antigravity CLI 설정 문서 → 권한 모드, 샌드박스

2. 화면·표시#

키	`/config` 이름	기본값	하는 일
`altScreenMode`	Rendering Mode	`default`	`default`(대화는 인라인, diff 보기 같은 전체 화면은 대체 화면), `always`(TUI 전체를 대체 화면에서), `never`(`settings.json`에서만, 대체 화면을 쓰지 않음)
`colorScheme`	Color Scheme	`terminal`	`terminal`, `light`, `solarized light`, `colorblind-friendly light`, `dark`, `solarized dark`, `colorblind-friendly dark`, `tokyo night`
`runningLightSpeed`	Animation Speed	`medium`	진행 표시 애니메이션 속도 `fast`·`medium`·`slow`·`off`
`verbosity`	Verbosity	`medium`	`high`(도구 호출·명령·생각을 모두), `medium`(묶어서 요약, 명령과 응답은 보임), `low`(응답만, 도구 활동은 토큰 사용 요약으로)
`hideActiveItems`	Show Active Tasks	`false`(보임)	프롬프트 아래 실행 중인 서브에이전트·백그라운드 작업 목록. 끄면 `"hideActiveItems": true`로 저장
`copyOnSelect`	Copy on Select	켜짐	대체 화면 모드에서 마우스로 고른 글자를 놓을 때 클립보드에 복사
`clearScrollbackOnResize`	—	`true`	인라인 표시에서 창 크기를 바꿔 다시 그릴 때 터미널 스크롤백을 지운다. `false`면 이전 출력을 남긴다
`useTerminalCursor`	—	`false`	블록 커서 대신 터미널 자체 커서 모양을 쓴다

3. 편집기·알림#

키	`/config` 이름	기본값	하는 일
`editor`	Editor	`auto`	아티팩트·파일을 열고 프롬프트를 쓸 때(Ctrl+G) 여는 외부 편집기. `auto`는 `$EDITOR`, 없으면 macOS·Linux는 `vim`, Windows는 `edit` 다음 `notepad`
`editorMode`	Editor Mode	`default`	프롬프트 입력창 자체의 편집 방식. `vim`이면 모드 편집. `editor`와는 별개
`vimInsertFirst`	Editor Mode › Insert First	꺼짐	`editorMode`가 `vim`일 때 Insert 모드로 시작하고 Enter로 제출
`notifications`	Notifications	꺼짐	승인·답이 필요하거나 턴이 끝나면 터미널 벨과 데스크톱 알림

4. 대화#

키	`/config` 이름	기본값	하는 일
`queuedMessages`	Queued Messages	`queue`	에이전트가 일하는 중 보낸 메시지를 턴이 끝날 때까지 잡아 둘지(`queue`), 바로 끼어들어 보낼지(`send-immediately`). Alt+M으로 한 번만 반대로 보낸다
`pickerGrouping`	Conversation Picker Grouping	`none`	`/resume` 목록을 최근순 한 목록(`none`)으로, 워크스페이스별(`grouped`)로. 목록에서 Ctrl+F로 그 세션만 바꾼다
`historySize`	—	`2000`	디스크에 남길 프롬프트 기록 수. `-1`은 모두, `0`은 지움
`disableSlashCommands`	—	`false`	헤드리스 모드(`-p`)에서 `/`로 시작하는 프롬프트를 명령·스킬로 돌리지 않고 그대로 모델에 보낸다(`--disable-slash-commands`와 같음)

5. 모델·계정·크레딧#

키	`/config` 이름	기본값	하는 일·조건
`model`	— (`/model`로 고름)	`""`	`/model`로 고른 모델을 이름표로 저장. 그 모델을 더 쓸 수 없으면 기본 모델을 쓰고 경고
`modelProvider`	—	`""`	`"gemini"`면 `GEMINI_API_KEY`의 키로 Gemini API에 직접 요청
`useG1Credits`	Use AI Credits	꺼짐	플랜 할당량을 다 쓴 뒤 AI 크레딧으로 모델 요청. business 계정에는 보이지 않음
(키 없음)	Enable Telemetry	—	사용 데이터 수집. `settings.json`이 아니라 계정에 저장, business 계정은 항상 꺼짐
`showTips`	Show Tips	켜짐	응답을 만드는 동안 사용 팁 표시
`showFeedbackSurvey`	Show Feedback Survey	켜짐	작업 뒤 짧은 설문
`trustedWorkspaces`	—	`[]`	CLI가 물었을 때 신뢰하기로 한 폴더 목록. CLI가 직접 추가한다

6. 객체 키#

키	하는 일·조건
`permissions`	allow·ask·deny 규칙. 규칙은 `action(target)` 문자열(예: `command(git status)`, `read_url(github.com)`, 여는 괄호 앞에 공백 없음). deny가 ask보다, ask가 allow보다 앞선다. 파싱하지 못한 규칙은 무시한다. 이 키는 `/permissions`의 Global 범위이고, CLI는 Project·Shared 범위 규칙과 합친다
`statusLine`, `title`	내 스크립트로 상태 줄·창 제목을 그린다. `command`(sh -c로 실행, stdin으로 세션 상태 JSON), `type`(`command`만), `enabled`, `padding`·`stack_with_default`(`statusLine`만). `true`/`false`로만 쓰면 `command`가 없어 스크립트가 돌지 않는다
`sandboxProxy`	샌드박스 안 명령의 네트워크를 CLI 내장 프록시 대신 내 HTTP 프록시로 보낸다. 샌드박스가 켜져 있을 때만 적용되고, 그때는 내 프록시가 `read_url` 규칙을 강제해야 한다. `address`+`certFile`, 필요하면 `username`+`password`를 짝으로. 짝이 빠지면 무시한다
`customModelsConfig`	Gemini API 키를 쓸 때 `/model`에 모델을 더한다. `modelProvider`가 `"gemini"`이고 `GEMINI_API_KEY`가 있을 때만 읽고, Google 계정으로 로그인하면 무시한다
`gcp`	"Use a Google Cloud project" 로그인 옵션이 저장한다. `project`(프로젝트 ID), `location`(`global`·`us`·`eu`). 다음 로그인을 채우는 데 쓰므로 직접 고칠 필요는 없다

permissions 예(원본):

json

{
  "permissions": {
    "allow": ["command(git status)", "read_url(github.com)"],
    "ask": ["command(git push)"],
    "deny": ["write_file(.env)"]
  }
}

근거: Antigravity CLI 설정 문서. 지원하는 동작(action) 목록과 대상 맞춤 규칙은 원본이 Agent permissions 문서로 넘기며, 이 위키에는 아직 없다.

단축키 파일 (2026-10-29 기준)#

keybindings.json은 TUI 동작 하나를 키 배열에 대응시킨다. Antigravity CLI 설정 문서

json

{
  "cli.clear_screen": ["ctrl+l"],
  "prompt.insert_newline": ["shift+enter", "ctrl+j"],
  "edit.open_editor": ["ctrl+g"]
}

빈 배열 []이면 그 기본 단축키를 끈다.
형식이 잘못된 동작은 기본값으로 돌아가고, 나머지 올바른 대응은 읽는다.
cli.exit(Ctrl+D·Ctrl+C)와 cli.enter(Enter)는 보호돼 끌 수 없다.
모두 되돌리려면 파일을 지운다: rm ~/.gemini/antigravity-cli/keybindings.json

슬래시 명령 (2026-10-29 기준)#

입력창에 /를 치면 명령 고르기 메뉴가 뜬다. 원본 표를 하는 일별로 묶었다. 근거는 모두 Antigravity CLI 명령 레퍼런스다. 명령마다 세부 동작은 원본이 개별 문서로 넘긴다.

하는 일	명령(별칭)	원본 설명 요약
도움말·종료	`/help`, `/exit`(`/quit`)	명령·단축키 도움말 패널, 세션 닫기
설정	`/config`(`/settings`), `/model`, `/effort [level]`, `/permissions`, `/keybindings`, `/statusline`, `/title [on/off]`	설정 편집기, 모델 고르기(`/model <model> <prompt>`는 기본값을 바꾸지 않고 프롬프트 하나만 다른 모델로), 추론 노력 수준(`low`~`max`, 모델에 따라), 도구 권한 관리자, 단축키 편집기, 상태 줄, 창 제목
확장 요소 확인·관리	`/skills`(`/skills reload`), `/mcp`, `/hooks`, `/plugin`(`/plugins`), `/agents`, `/tasks`	로드된 로컬·전역 스킬 보기와 디스크에서 다시 읽기, MCP 서버 관리자, 활성 훅 보기, 플러그인 관리자(`install`·`uninstall`·`enable`·`disable`·`list`), Agent Manager 패널(사용자 에이전트 고르기·백그라운드 서브에이전트 보기), 백그라운드 셸 작업 로그
계획·추론	`/plan [task]`, `/grill-me [task]`, `/goal <objective>`, `/boost <task>`, `/teamwork-preview <task>`(`/teamwork`)	코드베이스를 살피고 검토할 구현 계획 쓰기, 일 시작 전 한 번에 하나씩 질문(추천 답 포함), 목표가 확인될 때까지 중간 멈춤 없이 진행, 멀티 에이전트 깊은 추론, 협업 에이전트 팀(유료 플랜)
작업 위임	`/browser <task>`, `/btw <query>`, `/schedule <when> <task>`, `/learn [instruction]`	브라우저 서브에이전트에 웹 작업, 본 대화를 끊지 않는 곁 질문, 한 번 또는 반복 일정으로 에이전트 깨우기, 세션 중 고친 점을 규칙·스킬 제안으로 남기기(검토 후 반영)
대화	`/clear`(`/new`), `/resume`(`/switch`, `/conversation`), `/rewind`(`/undo`), `/fork`(`/branch`), `/rename <name>`	화면과 대화 맥락 초기화, 이전 대화 불러오기, 이전 메시지로 대화 되감기, 대화를 새 병렬 세션으로 복제, 이름 바꾸기
보기·도구	`/diff`, `/artifact`, `/context`, `/codesearch`(`/cs`, `/search`), `/copy [n\|btw]`, `/open <path>`, `/add-dir <path>`	변경 보기, Artifact Review 패널, 컨텍스트 사용량 시각화, 코드 검색, 응답 복사, 기본 편집기로 열기, 워크스페이스에 디렉터리 추가
계정·사용량	`/usage`(`/quota`), `/credits`, `/logout`	모델 할당량 사용량, 남은 크레딧과 구매 링크, 프로필 연결 끊고 보안 키링에서 인증 토큰 지우기
그 밖	`/changelog`, `/feedback`, `/remote-control [on/off]`, `/voice`(`/record`)	릴리스 노트, 피드백, 원격 제어 켜기·끄기, 마이크 받아쓰기

기본 단축키 (2026-10-29 기준)#

키	하는 일
`Esc`	열린 패널 닫기, 진행 중인 출력 멈추기, 빈 프롬프트 지우기
`Ctrl+C`	세션 종료(에이전트가 일하는 중이면 확인)
`Ctrl+D`	프롬프트가 비었을 때 종료
`Shift+Enter`·`Ctrl+J`	줄바꿈(제출하지 않음)
`Shift+Tab`	실행 모드 돌리기 `default` > `accept-edits` > `auto` > `plan`(`auto`는 쓸 수 있는 곳에서만)
`Ctrl+O`	도구 추론 출력 펼치기·접기
`Ctrl+R`	Artifact Review 패널
`Ctrl+G`	외부 편집기로 프롬프트 쓰기
`Ctrl+V`	이미지·클립보드 붙여넣기
`Alt+J`·`Ctrl+K`	확인을 기다리는 다음 서브에이전트로 이동·대기 동작 바로 승인
`y`·`n`·`A`	승인 창에서 승인·거부, Review 패널에서 아티팩트 모두 승인

근거: Antigravity CLI 명령 레퍼런스. 바꾸는 법은 위 "단축키 파일" 절.

실행 플래그 (2026-10-29 기준)#

agy를 시작할 때 붙인다. 플래그 값은 그 세션에만 적용되고 settings.json에 저장되지 않는다. Antigravity CLI 명령 레퍼런스 Antigravity CLI 설정 문서

플래그	기본값	하는 일·조건
`--mode`	`""`	이번 세션의 실행 모드 `accept-edits`·`auto`·`plan`. `auto`는 Preview, macOS·Linux `v1.3.5+`·Windows `v1.4.4+`, 터미널 샌드박스 필요, business·enterprise 계정 불가
`--model`, `--effort`, `--agent`	—	이번 세션의 모델(`agy models` 참고), 추론 노력, 에이전트(`agy agents` 참고)
`--add-dir`	`[]`	워크스페이스에 디렉터리 추가(여러 번 가능)
`-c`·`--continue`, `--conversation`	`false`, —	가장 최근 대화 이어 하기, ID로 이전 대화 재개
`-i`·`--prompt-interactive`	—	첫 프롬프트를 돌리고 대화형으로 계속
`-p`·`--print`·`--prompt`	—	헤드리스 모드: 프롬프트 하나를 비대화형으로 돌리고 응답 출력
`--output-format`, `--input-format`, `--json-schema`, `--print-timeout`, `--disable-slash-commands`	`text`, `text`, —, `0s`, `false`	`-p` 모드의 출력 형식(`text`·`json`·`stream-json`), 입력 형식, 구조화 출력 스키마, 시간 제한(`0`은 턴이 끝날 때까지), 명령·스킬 펼치기 끄기
`--sandbox`	`false`	터미널 샌드박스로 실행. `v1.4.4+`에서 기기가 샌드박스를 지원하지 않으면 효과 없음
`--dangerously-skip-permissions`	`false`	모든 도구 권한 요청을 묻지 않고 자동 승인. 이 플래그와 deny 규칙·훅·샌드박스의 관계는 원본에 없다
`--remote-control`	`false`	시작할 때 원격 제어 연결 만들기
`--project`, `--new-project`	—, `false`	이번 세션의 프로젝트 ID·이름, 새 프로젝트 만들기
`--log-file`	—	로그 파일 경로 바꾸기