WINDOWS · ANTIGRAVITY CLI · POWERSHELL

Antigravity CLI 하단에 실시간 Quota & 상태 표시줄 설정하기 (Windows 이모지 깨짐 해결)

Gemini 모델, 컨텍스트 사용량, Quota 잔여량, Git 브랜치와 작업 상태를 터미널 하단에서 확인하는 방법을 소개합니다. 설치부터 설정 확인, Classic 모드, 이모지 직접 교체, 배지 테두리 수정까지 Windows 개발자 관점에서 정리했습니다.

작성 기준일: 2026년 10월 24일

핵심 요약

• Antigravity CLI는 사용자 정의 스크립트를 이용한 상태 표시줄을 지원합니다.
• 커뮤니티 프로젝트를 이용하면 모델, Git, Context, Quota, 실행 상태 등을 한곳에 표시할 수 있습니다.
• Nerd Font 아이콘이 깨진다면 프로젝트의 -Classic 옵션을 사용할 수 있습니다.
• 직접 수정하는 것을 선호한다면 아이콘 정의를 유니코드 이모지로 교체하는 방법도 있습니다.
• Quota는 사용 한도를 늘리는 기능이 아니라 CLI가 전달하는 사용량 정보를 표시하는 기능입니다.

1. Antigravity CLI 상태 표시줄이란?

Antigravity CLI의 Statusline은 에이전트의 현재 상태와 개발 환경 정보를 터미널 하단에 표시하는 기능입니다. 기본 상태 표시줄 대신 사용자 정의 스크립트를 연결하면 필요한 정보를 원하는 형태로 배치할 수 있습니다.

이번 글에서는 다음 오픈소스 프로젝트를 사용합니다.

Antigravity CLI Statusline

Windows에서는 PowerShell 렌더러인 statusline.ps1을 사용합니다. 설치 프로그램은 렌더러를 사용자 폴더에 복사하고 CLI 설정에 연결합니다.

GitHub 저장소 및 최신 README 확인하기

상태 표시줄에서 확인할 수 있는 정보

에이전트 상태

READY, THINKING, WORKING, TOOL

모델 및 프로젝트

선택된 모델, 작업 디렉터리, Git 브랜치

컨텍스트 사용량

컨텍스트 사용률, 토큰 수, 컨텍스트 한도

Quota 및 작업 정보

지원되는 Quota 잔여량, 리셋 시간, 작업 통계

주의: 실제 표시 항목은 CLI가 전달하는 JSON 데이터, 모델, 터미널 너비와 스크립트 버전에 따라 달라집니다. 모든 정보가 항상 제공되는 것은 아닙니다.

2. 설치 전 확인할 사항

공식 문서에서는 statusLine 설정을 통해 CLI가 전달하는 상태 데이터를 사용자 정의 명령어로 렌더링하도록 구성할 수 있다고 설명합니다.

• 공식 문서: Statusline 사용자 정의
• 공식 문서: /statusline 명령어
• GitHub: 설치 및 설정 안내

보안 주의

원격 PowerShell 스크립트를 바로 실행하면 다운로드한 코드가 즉시 실행됩니다. 설치 전에 공개 저장소의 스크립트를 확인하고, 일반 사용자 권한으로 진행하세요. 관리자 권한은 기본 설치에 필요하지 않습니다.

3. Windows PowerShell에서 설치하기

Step 1. 설치 스크립트 다운로드

PowerShell을 열고 아래 명령어를 실행합니다. 먼저 파일로 저장하면 내용을 확인한 다음 실행할 수 있습니다.

$installer = Join-Path $env:TEMP "agy-statusline-install.ps1"
$url = "https://raw.githubusercontent.com/weby-homelab/antigravity-cli-statusline/main/install.ps1"

Invoke-WebRequest -Uri $url -OutFile $installer

Step 2. 다운로드한 코드 확인

Get-Content -LiteralPath $installer

설치 스크립트가 어떤 경로에 파일을 생성하고, 어떤 설정을 변경하는지 확인합니다. 검토할 수 없다면 실행을 보류하세요.

Step 3. 설치 실행

내용을 검토했다면 다음 명령어로 설치를 진행합니다.

powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer

설치가 정상적으로 완료되었는지는 콘솔 메시지와 생성된 파일을 통해 확인해야 합니다. 이 글에서 실제 PC의 설치 성공을 직접 측정한 것은 아닙니다.

Step 4. 설치 파일 확인

Get-ChildItem "$HOME\.antigravity"

Get-Content "$HOME\.gemini\antigravity-cli\settings.json"

파일 또는 경로	역할
%USERPROFILE%\.antigravity\statusline.ps1	PowerShell 상태 표시줄 렌더러
%USERPROFILE%\.antigravity\uninstall.ps1	제거 스크립트
%USERPROFILE%\.gemini\antigravity-cli\settings.json	CLI 설정 파일

위 경로는 기본 설치 경로입니다. AGY_STATUSLINE_INSTALL_DIR 환경 변수를 사용했다면 렌더러 경로가 달라질 수 있습니다.

4. Statusline 설정 확인하기

설치 프로그램은 보통 settings.json에 상태 표시줄 명령어를 등록합니다. Windows 설정의 형태는 다음과 같습니다.

{
  "statusLine": {
    "type": "command",
    "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/사용자/.antigravity/statusline.ps1",
    "enabled": true
  }
}

위 JSON은 구조를 설명하기 위한 예시입니다. 실제 설정 파일에는 본인의 사용자 경로와 설치 프로그램이 작성한 명령어가 들어가야 합니다. 기존 파일 전체를 위 예제로 덮어쓰지 마세요.

설정 적용 확인

1. statusLine 항목이 존재하는지 확인합니다.
2. command가 실제 스크립트 경로를 가리키는지 확인합니다.
3. enabled가 true인지 확인합니다.
4. Antigravity CLI를 종료한 후 다시 실행합니다.
5. 터미널 하단에 상태 표시줄이 나타나는지 확인합니다.

공식 CLI에서는 /statusline 명령어로 상태 표시줄을 켜거나 끌 수도 있습니다. 설정을 초기화하려면 공식 문서에서 안내하는 /statusline delete 명령어를 사용할 수 있습니다.

5. Windows에서 아이콘이 깨지는 원인

상태 표시줄 기본 모드는 Nerd Font 전용 글리프를 사용합니다. 해당 글리프를 지원하지 않는 글꼴에서는 다이아몬드, 빈 사각형 또는 대체 문자로 나타날 수 있습니다.

문제 해결 방법은 두 가지입니다.

1. Classic 모드 사용: 원래 스크립트 구조를 크게 변경하지 않고 글꼴 호환성을 개선합니다.
2. 유니코드 이모지로 직접 교체: 원하는 아이콘을 직접 지정해 사용할 수 있습니다.

두 방법은 대체 관계이며, 먼저 Classic 모드를 시도한 다음 직접 아이콘을 교체해도 됩니다. 실제로 이모지 교체를 통해 표시 문제를 해결했다면 아래 방법을 적용할 수 있습니다.

6. 방법 A: Classic 모드 적용하기

프로젝트에서 제공하는 Classic 모드는 Nerd Font 전용 아이콘 대신 텍스트 라벨과 일반적인 유니코드 블록 문자 등을 사용합니다. 완전한 ASCII 전용 모드는 아니지만, Nerd Font가 없는 환경에서 표시 문제를 줄이는 데 유용합니다.

Step 1. 설정 파일 열기

notepad "$HOME\.gemini\antigravity-cli\settings.json"

Step 2. command에 -Classic 추가하기

기존 statusLine.command 끝에 -Classic을 추가합니다.

{
  "statusLine": {
    "type": "command",
    "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/사용자/.antigravity/statusline.ps1 -Classic",
    "enabled": true
  }
}

기존 설정의 다른 속성은 유지하세요. 실제 사용자 경로에 맞게 변경한 뒤 저장하고 CLI를 재실행합니다.

7. 방법 B: 아이콘을 유니코드 이모지로 직접 교체하기

Classic 모드 대신 아이콘을 직접 바꾸고 싶다면 statusline.ps1의 아이콘 정의 블록을 수정할 수 있습니다. 아래 코드는 실제 적용에 사용한 이모지 매핑입니다.

Step 1. 스크립트 백업하기

$script = "$HOME\.antigravity\statusline.ps1"
$backup = "$script.bak"

Copy-Item -LiteralPath $script -Destination $backup -Force

백업 파일이 생성되었는지 확인한 다음 편집을 진행합니다.

Step 2. 아이콘 정의 블록 수정하기

notepad "$HOME\.antigravity\statusline.ps1"

파일에서 아이콘을 정의하는 } else { ... } 블록을 찾습니다. 기존 구조를 확인한 뒤 해당 아이콘 정의 부분을 다음 코드로 교체합니다.

} else {
    $DOT_L1 = "${FG_GRAY} | ${R}"
    $DOT_L2 = "${FG_GRAY} | ${R}"
    $ICON_READY = "🟢"
    $ICON_THINKING = "💡"
    $ICON_WORKING = "⚙️"
    $ICON_TOOL = "🔧"
    $ICON_STATE_UNKNOWN = "⏳"
    $ICON_VCS = "🌿"
    $ICON_MODEL = "🤖"
    $ICON_SANDBOX_NET = "🌐"
    $ICON_SANDBOX_NONET = "🔒"
    $ICON_SANDBOX_OFF = "❌"
    $ICON_CONTEXT_BAR = "📊"
    $ICON_ARTIFACTS = "📄"
    $ICON_SUBAGENTS = "🤖"
    $ICON_TASKS = "📋"
    $ICON_DIR = "📁"
    $ICON_CONV = "💬"
    $ICON_TOK_SUM = "🪙"
    $ICON_RESET = "⌛"
    $ICON_AC = "🔌"
    $ICON_BAT = "🔋"
}

중요: 코드 블록 교체 범위 확인

위 코드는 아이콘 정의 블록입니다. 파일의 다른 부분을 포함해 통째로 교체하는 코드가 아닙니다. 기존 if/else 구조와 일치하는지 확인하고, 해당 블록 안의 아이콘 정의만 수정하세요.

Step 3. UTF-8 인코딩 유지하기

PowerShell 스크립트에 이모지가 들어가면 저장 인코딩도 중요합니다. 프로젝트 README에서는 Windows PowerShell 5.1에서 스크립트를 올바르게 읽을 수 있도록 기존 UTF-8 BOM을 유지하라고 안내합니다.

• 기존 파일의 인코딩을 확인합니다.
• 편집 후 이모지가 정상적으로 저장되었는지 확인합니다.
• UTF-8 BOM이 제거되지 않았는지 확인합니다.
• 문제가 발생하면 백업 파일을 이용해 원상 복구합니다.

Step 4. CLI 재실행 후 확인하기

파일을 저장하고 Antigravity CLI를 재실행합니다. 상태 표시줄의 아이콘이 정상적으로 나타나는지, 배지와 줄 정렬이 유지되는지 확인합니다.

이모지는 터미널과 글꼴에 따라 표시 폭이 달라질 수 있습니다. 따라서 특정 Windows 환경에서 정상적으로 표시되었다고 해서 모든 터미널에서 동일한 결과를 보장하는 것은 아닙니다.

8. 선택 사항: 배지 테두리 깨짐 해결하기

아이콘은 정상적으로 표시되지만 숫자 배지의 양쪽 장식 문자까지 깨진다면 make_badge 함수도 확인할 수 있습니다. Nerd Font 전용 테두리 대신 공백 패딩을 사용하면 테두리 글리프 의존성을 줄일 수 있습니다.

Step 1. 기존 make_badge 함수 찾기

statusline.ps1에서 function make_badge를 검색합니다. 수정 전 원본 파일을 백업했는지 다시 확인합니다.

Step 2. 해당 함수 교체하기

기존 함수의 변수명과 분기 구조가 아래 코드와 일치하는 경우에만 적용합니다.

function make_badge($icon, $val, $icon_color) {
    $bg_color = "236"
    if ($USE_CLASSIC_ICONS) {
        $ansi_c = to_ansi_color $icon_color
        if ($icon -eq $val) {
            return "${ansi_c}${val}${R}"
        } else {
            return "${ansi_c}${icon} ${NUM_COLOR}${val}${R}"
        }
    } else {
        return "$ESC[48;5;${bg_color}m $ESC[38;5;${icon_color}m${icon} $ESC[38;5;255m${B}${val}${R}$ESC[48;5;${bg_color}m $ESC[0m"
    }
}

주의: 이 함수는 기존 스크립트의 ANSI 색상 변수, Classic 모드 분기 및 배지 호출 방식과 맞아야 합니다. 저장소 버전이 변경되었다면 최신 소스와 비교한 후 적용하세요. 실제 파일과 구조가 다르면 그대로 덮어쓰지 마세요.

Step 3. 배지 정렬 확인하기

CLI를 재실행한 뒤 아이콘뿐 아니라 숫자, 색상, 공백 간격과 줄바꿈도 확인합니다. 공백 패딩은 Nerd Font 테두리 문자에 대한 의존성을 줄이지만, 모든 글꼴에서 동일한 정렬을 보장하지는 않습니다.

9. 설치 및 수정 결과 확인하기

스크립트 버전 확인

$script = "$HOME\.antigravity\statusline.ps1"
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $script -Version

아이콘 안내 확인

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$HOME\.antigravity\statusline.ps1" -Legend

이 명령어는 렌더러의 버전과 아이콘 안내를 확인하는 용도입니다. 실제 CLI의 상태 데이터가 전달되는 상황에서 정상 출력되는지는 Antigravity CLI를 재실행해 별도로 확인해야 합니다.

문제 해결 체크리스트

• 상태 표시줄이 보이지 않으면 설정 경로, 명령어, enabled 값을 확인합니다.
• 아이콘이 깨지면 Classic 모드를 적용하거나 Nerd Font 지원 여부를 확인합니다.
• 이모지 수정 후 문자가 깨지면 UTF-8 인코딩과 BOM을 확인합니다.
• Quota가 표시되지 않으면 현재 CLI가 해당 데이터를 제공하는지 확인합니다.
• 배지가 어긋나면 터미널 너비, 이모지 문자 폭, 공백 패딩을 확인합니다.
• 스크립트 오류가 발생하면 백업 파일로 복원하고 원본 코드와 비교합니다.

10. Quota와 Context를 정확하게 이해하기

상태 표시줄을 사용할 때는 Quota와 Context를 구분해야 합니다.

항목	의미	주의점
Context	대화와 작업에 사용되는 컨텍스트 윈도우의 사용량	계정의 전체 Quota와 다른 지표
Quota	CLI에서 제공하는 모델 또는 사용 한도 관련 정보	사용 모델과 제공 데이터에 따라 표시가 달라질 수 있음
리셋 시간	Quota 데이터에 포함된 초기화 예정 시각 또는 남은 시간	실제 계정 정책 및 제공 데이터 기준으로 해석해야 함

5시간 또는 7일 기준의 Quota 정보가 표시되더라도 모든 모델에서 같은 버킷이 제공되는 것은 아닙니다. 상태 표시줄은 사용량을 보여주는 도구이며, 사용 한도를 증가시키거나 실제 리셋 정책을 변경하지 않습니다.

11. 제거 및 원상 복구

방법 1. 설치 프로그램의 제거 스크립트 사용

기본 설치 경로를 사용했다면 다음 명령어로 제거 스크립트를 실행할 수 있습니다.

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$HOME\.antigravity\uninstall.ps1"

제거 전에 설정 파일과 백업 파일을 별도 위치에 복사해 두세요. 저장소의 현재 제거 스크립트가 settings.json.bak을 정리할 수 있으므로, 기존 백업이 필요하다면 미리 보관하는 것이 안전합니다.

방법 2. 이모지 수정만 되돌리기

이모지 교체 또는 배지 함수 수정만 되돌리려면 CLI를 종료하고, 앞서 생성한 백업 파일을 원본 경로에 복원합니다.

$script = "$HOME\.antigravity\statusline.ps1"
$backup = "$script.bak"

Copy-Item -LiteralPath $backup -Destination $script -Force

이 명령어는 백업 파일이 실제로 존재한다는 전제에서 동작합니다. 복원 후 CLI를 재실행해 상태 표시줄을 확인하세요.

12. 자주 묻는 질문

Q1. 상태 표시줄은 매초 자동 갱신되나요?

독립적인 초당 갱신 도구라고 보기는 어렵습니다. 공식 문서에 따르면 CLI가 에이전트 상태 변경 시 스크립트를 실행해 상태 데이터를 전달합니다. 따라서 갱신 주기는 CLI의 실행 방식에 영향을 받습니다.

Q2. Quota가 표시되지 않는 이유는 무엇인가요?

CLI가 해당 모델의 Quota 데이터를 제공하지 않거나, 사용 중인 모델에 맞는 정보가 없는 경우 표시되지 않을 수 있습니다. 상태 표시줄에 값이 없다는 사실만으로 계정의 실제 잔여량을 판단해서는 안 됩니다.

Q3. 이모지 교체와 Classic 모드 중 무엇이 좋나요?

수정 범위를 최소화하고 싶다면 Classic 모드를 먼저 권장합니다. 직접 이모지를 지정하고 싶거나 원하는 아이콘 구성을 만들고 싶다면 이모지 교체 방식을 사용할 수 있습니다. 이모지 방식은 글꼴과 터미널에 따라 표시 폭이 달라질 수 있습니다.

Q4. 이 설정이 Gemini 모델의 토큰 사용량을 줄여 주나요?

아닙니다. 상태 표시줄은 상태 및 사용량 정보를 표시하는 기능입니다. 프롬프트 길이, 모델 선택, 작업 분할 등 실제 토큰 사용에 영향을 주는 설정과는 별개입니다.

마무리

Antigravity CLI의 사용자 정의 Statusline은 모델, Git 브랜치, Context, Quota와 실행 상태를 터미널 하단에서 확인할 수 있게 해주는 개발 도구입니다.

Windows에서 아이콘이 깨진다면 먼저 Classic 모드를 적용해 보고, 원하는 표시 형태가 있다면 아이콘 정의를 유니코드 이모지로 직접 교체할 수 있습니다. 배지 테두리까지 문제가 있다면 make_badge 함수도 점검하되, 현재 설치된 스크립트와 코드 구조가 일치하는지 확인한 뒤 수정해야 합니다.

가장 중요한 것은 설치 스크립트를 검토하고, 기존 설정과 파일을 백업하며, 수정 후 실제 CLI에서 결과를 확인하는 것입니다.

공식 문서 및 출처

• Google Antigravity CLI — Statusline 사용자 정의
• Google Antigravity CLI — /statusline 명령어
• GitHub — Antigravity CLI Statusline
• GitHub — Windows 설치 스크립트
• GitHub — PowerShell 렌더러 원본

정보 기준일: 2026년 10월 24일. 설치 명령어, 옵션, 설정 경로 및 제거 동작은 저장소 업데이트에 따라 변경될 수 있으므로 실제 적용 전에 공식 문서와 최신 소스를 다시 확인하세요.

#AntigravityCLI #GoogleAntigravity #PowerShell #Windows개발환경 #Statusline #Quota #ContextWindow #Gemini #개발도구