KB-5C88

Antigravity wrapper for gemini-cli stabilized — 2026-05-26

3 min read Revision 1
antigravitygemini-cligemini-gocodexconnectionstability2026-05-26

Antigravity wrapper for gemini-cli stabilized — 2026-05-26

Status: ANTIGRAVITY_WRAPPER_GEMINI_CLI_INTERACTIVE_PASS Host: Mac local của Huyền VPS smoke target: contabo Rule: Gemini CLI legacy tạm thời GIỮ NGUYÊN. Chưa remove/uninstall trong giai đoạn này.


1. Root cause đã sửa

Lỗi user thấy:

gemini-cli
Antigravity CLI: Executing task...
nmhuyen@Nguyens-MacBook-Air ~ %

Nguyên nhân: còn sót fake/stub ~/bin/agy đứng trước binary thật trong một số shell PATH. Stub này thoát ngay với dòng Antigravity CLI: Executing task....

Đã sửa bằng cách thay /Users/nmhuyen/bin/agy thành shim gọi binary thật:

/Users/nmhuyen/.local/bin/agy

Shim cũng xử lý compatibility cho lệnh cũ dạng agy chat bằng cách bỏ chat và mở interactive thật.


2. Evidence PASS

gemini-cli resolve về wrapper local:

gemini-cli is an alias for /Users/nmhuyen/bin/gemini-cli
gemini-cli is /Users/nmhuyen/bin/gemini-cli

Antigravity binary thật:

/Users/nmhuyen/.local/bin/agy
version: 1.0.2

Interactive test đúng lệnh user:

script -q /tmp/gemini-cli-user-repro.log zsh -ic 'gemini-cli'

Log có TUI thật:

Antigravity CLI 1.0.2
[EMAIL_REDACTED]
Gemini 3.5 Flash (Medium)
~/Documents/Manual Deploy/web-test
>
? for shortcuts

SSH contabo smoke read-only PASS:

vmi3080463
root
Tue May 26 13:57:25 UTC 2026

3. Files changed

  • /Users/nmhuyen/bin/agy

Backups:

  • /Users/nmhuyen/bin/agy.bak_falsepass_20260526_205616
  • /Users/nmhuyen/bin/gemini-cli.bak_falsepass_20260526_205616
  • /Users/nmhuyen/.zshrc.bak_falsepass_20260526_205616

4. Stability rule

Không làm phase remove Gemini CLI legacy lúc này.

Cho đến cutover date do user quyết, mọi agent phải coi trạng thái hiện tại là:

gemini-cli / gemini-go = Antigravity wrapper path đang hoạt động
legacy Gemini CLI = giữ nguyên để rollback / tránh mất đường cũ

Cấm trong các phase tiếp theo nếu chưa được user yêu cầu rõ:

  • uninstall Gemini CLI legacy
  • xoá /opt/homebrew/bin/gemini
  • xoá backup wrapper
  • đổi credential Google
  • tạo app/bot/credential mới
  • sửa VPS ngoài smoke test read-only

5. Smoke checklist cho lần sau

Khi cần kiểm tra nhanh:

zsh -ic 'type -a gemini-cli; type -a agy; gemini-cli --version || true'
script -q /tmp/gemini-cli-user-repro.log zsh -ic 'gemini-cli'
ssh contabo 'hostname && whoami && date -u'

PASS chỉ khi gemini-cli no-args mở TUI interactive thật, không in Antigravity CLI: Executing task... rồi thoát.


6. Next phase — CHƯA LÀM

Sau cutover date, nếu user yêu cầu, mới tạo phase riêng:

Retire Gemini CLI legacy safely

Phase đó phải có backup, PATH audit, rollback path, và verify rằng gemini-cli / gemini-go vẫn mở Antigravity interactive sau khi legacy bị gỡ.