Antigravity CLI (agy): dùng agent ngay trong terminal

TL;DR: Antigravity CLI đưa agent của Google xuống thẳng terminal qua binary agy. Cài bằng một lệnh curl (macOS/Linux) hoặc PowerShell (Windows), đăng nhập Google, và bạn giao task cho agent ở bất cứ đâu có shell — máy local, server SSH, hay script tự động. Bài 7 hướng dẫn cài đặt từng bước, workflow cơ bản, nơi đặt skills, và bối cảnh Gemini CLI nghỉ hưu nhường chỗ cho Antigravity CLI từ giữa tháng 06/2026.

Không phải lúc nào cũng tiện mở ứng dụng desktop. Khi bạn SSH vào server, viết script CI, hay đơn giản là kiểu người sống trong terminal, một agent gọi được bằng lệnh vẫn thực dụng hơn mọi giao diện đẹp. Antigravity CLI sinh ra cho đúng nhóm nhu cầu đó: toàn bộ năng lực agent của Antigravity, gói trong một binary tên agy.

Bài này là phần 7 của series. Nếu bạn mới biết tới nền tảng này, nên bắt đầu từ bài 1: Google Antigravity là gì để nắm bức tranh chung trước khi xuống terminal.

Antigravity CLI là gì và khi nào nên dùng?

Antigravity có hai hình hài: ứng dụng desktop (Editor + Agent Manager) và Antigravity CLI — phiên bản dòng lệnh. Cùng một agent, cùng tài khoản, cùng hạn mức model; khác nhau ở nơi bạn đứng làm việc.

Mình chọn CLI thay vì app trong các tình huống:

• Làm việc trên máy từ xa. SSH vào VPS, không có GUI — CLI là lựa chọn duy nhất.
• Tự động hoá. Gọi agent từ script, cron job, hay pipeline CI để làm các việc lặp: dọn code, cập nhật docs, chạy kiểm tra định kỳ.
• Task nhỏ, nhanh. Sửa một hàm, viết một script — gõ lệnh trong terminal nhanh hơn mở app, tạo project, chờ giao diện load.
• Thói quen terminal. Nếu bạn vốn sống với vim/tmux, CLI hoà vào workflow sẵn có thay vì bắt bạn đổi môi trường.

Ngược lại, khi cần review artifact trực quan, xem browser recording, hay điều phối nhiều agent song song, ứng dụng desktop với Agent Manager vẫn dễ chịu hơn hẳn. Hai công cụ bổ sung nhau chứ không thay thế nhau.

Cài đặt Antigravity CLI từng bước

Theo tài liệu cài đặt chính thức, mọi thứ gói gọn trong một lệnh.

macOS và Linux

Mở terminal và chạy:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Installer tải binary và đăng ký vào thư mục:

~/.local/bin/agy

Nếu gõ agy mà shell báo command not found, gần như chắc chắn ~/.local/bin chưa nằm trong PATH. Thêm dòng sau vào ~/.zshrc hoặc ~/.bashrc rồi mở terminal mới:

export PATH="$HOME/.local/bin:$PATH"

Windows

Mở PowerShell và chạy:

irm https://antigravity.google/cli/install.ps1 | iex

Binary được đặt tại:

C:\Users\<Username>\AppData\Local\agy\bin

Installer thường tự thêm đường dẫn này vào PATH; nếu không, bạn thêm tay trong Environment Variables.

Đăng nhập lần đầu

Chạy agy lần đầu, CLI sẽ mở luồng đăng nhập bằng tài khoản Google — cùng tài khoản bạn dùng cho ứng dụng desktop. Lưu ý cần kết nối mạng cho lần khởi tạo model đầu tiên; theo tài liệu công bố, sau bước này một số thao tác trên workspace local có thể chạy ở chế độ offline.

Toàn bộ quá trình, từ tải về tới đăng nhập xong, mất chưa tới mười phút trên máy sạch — tương đương trải nghiệm cài app desktop mà mình đã kể trong bài 2: cài đặt Antigravity.

Workflow cơ bản với agy trong terminal

Tư duy dùng CLI không khác app: bạn mô tả task, agent lập kế hoạch, thực thi, báo cáo. Chỉ là mọi thứ diễn ra dạng text trong terminal.

Một phiên làm việc điển hình của mình trông thế này:

1. cd vào thư mục dự án. CLI làm việc theo ngữ cảnh thư mục hiện tại — đứng đúng repo trước khi gọi agent.
2. Gõ agy để vào phiên tương tác. Từ đây bạn trò chuyện với agent như trong app: giao task, trả lời câu hỏi làm rõ, duyệt kế hoạch.
3. Giao task cụ thể. Ví dụ: "viết script Python đọc file CSV trong thư mục data và xuất báo cáo tổng hợp". Task càng rõ phạm vi, agent chạy càng gọn — nguyên tắc y hệt cách giao task trong app ở bài 4.
4. Duyệt trước khi cho chạy lệnh nhạy cảm. Agent hỏi xác nhận khi muốn chạy lệnh thay đổi hệ thống. Đọc kỹ rồi hãy đồng ý — kỷ luật này ở terminal còn quan trọng hơn ở app, vì lệnh shell sai một ly đi một dặm.
5. Kiểm tra kết quả bằng công cụ quen thuộc. git diff xem thay đổi, chạy test, rồi commit như bình thường.

Điều mình thích nhất: CLI ghép mượt vào các công cụ Unix sẵn có. Kết quả agent nằm ngay trong repo, git diff soi được từng dòng, và bạn giữ nguyên quy trình review code của đội — bạn nào chưa vững có thể ôn lại Git cơ bản cho người mới.

Gỡ lỗi cài đặt thường gặp

Vài trục trặc phổ biến mình gom được từ trải nghiệm cộng đồng, kèm cách xử lý nhanh:

• agy: command not found sau khi cài. Như đã nói ở trên, 90% là do PATH. Kiểm tra bằng echo $PATH | grep -o ".local/bin" — không thấy gì thì thêm export vào file cấu hình shell.
• Cài trên Linux báo lỗi thư viện. Antigravity yêu cầu glibc từ 2.28 và glibcxx từ 3.4.25 trở lên — tương đương Ubuntu 20, Debian 10, Fedora 36, RHEL 8 trở về sau. Distro quá cũ sẽ không chạy được; nâng cấp hệ điều hành là đường duy nhất.
• PowerShell chặn script trên Windows. Nếu gặp lỗi execution policy, mở PowerShell với quyền Administrator rồi chạy lại lệnh cài. Đây là cơ chế an toàn mặc định của Windows, không phải lỗi của installer.
• Đăng nhập treo ở bước mở trình duyệt. Máy không có GUI (server SSH) cần dùng luồng đăng nhập bằng mã trên máy khác theo hướng dẫn hiện trên terminal.

Bối cảnh: Gemini CLI nghỉ hưu, Antigravity CLI kế nhiệm

Nếu bạn từng dùng Gemini CLI, đây là thông tin cần biết: theo thông báo công bố, từ ngày 18/06/2026, Gemini Code Assist IDE Extensions và Gemini CLI ngừng phục vụ người dùng gói cá nhân, Google AI Pro và Google AI Ultra. Lộ trình Google đưa ra là chuyển sang Antigravity và Antigravity CLI.

Nói cách khác, Antigravity CLI không phải "thêm một công cụ nữa" mà là người kế nhiệm chính thức trong hệ sinh thái dòng lệnh của Google. Kinh nghiệm bạn tích luỹ với agy sẽ là kỹ năng dùng lâu dài. Với ai đang phân vân giữa các CLI agent — mình từng so sánh trải nghiệm Codex, Claude và Gemini khi vibe coding — thì yếu tố "được Google đầu tư dài hạn" là điểm cộng đáng cân nhắc của agy.

Skills: dạy CLI cách làm việc của bạn

Antigravity có hệ thống Skills — các gói hướng dẫn tự nạp khi yêu cầu của bạn khớp mô tả skill. Với CLI, vị trí đặt skill như sau:

Loại skill	Thư mục
Riêng cho Antigravity CLI	~/.gemini/antigravity-cli/skills
Dùng chung CLI + IDE	~/.gemini/skills

Mỗi skill là một thư mục chứa file SKILL.md mô tả quy trình. Ví dụ bạn tạo skill code-review/SKILL.md chứa checklist review của đội; lần sau gõ "review giúp mình thay đổi trong repo này", agent tự nạp checklist đó mà bạn không phải dán lại ngữ cảnh. Phần tuỳ biến sâu hơn — Rules, Workflows và cách chúng phối hợp với Skills — mình để dành trọn bài 8 của series.

Vài lưu ý thực dụng khi dùng antigravity cli hằng ngày

• Giữ task có phạm vi hẹp. Terminal không có Auxiliary Pane trực quan, nên task to sẽ khó theo dõi. Chia nhỏ luôn thắng.
• Đừng pipe secret vào hội thoại. API key, mật khẩu — đặt trong biến môi trường hoặc file gitignore, đừng dán thẳng vào prompt.
• Tận dụng cùng tài khoản với app. Hạn mức model dùng chung; nếu bạn chạy nhiều task nặng trên CLI, phần quota còn lại cho app sẽ ít đi. Chi tiết về hạn mức và cách phân bổ mình sẽ bàn ở bài 10.
• Cập nhật thường xuyên. CLI đang phát triển nhanh, chạy lại lệnh cài đặt là cách đơn giản để lên bản mới tại thời điểm viết bài.

Bạn có thể xem thêm các bài cùng chủ đề ở chuyên mục Công nghệ của blog.

Kết: agent trong túi áo terminal

Antigravity CLI mang đúng một lời hứa: ở đâu có shell, ở đó có agent. Cài một lệnh, đăng nhập một lần, và agy sẵn sàng nhận việc từ máy local tới server SSH — kế nhiệm chính thức của Gemini CLI trong hệ sinh thái Google. Với dân terminal, đây có lẽ là cánh cửa vào Antigravity tự nhiên nhất.

Giờ bạn đã có agent ở cả app lẫn terminal, bước tiếp theo là dạy nó làm việc theo chuẩn riêng của bạn: quy tắc code, quy trình lặp lại, kiến thức dự án. Tất cả nằm trong bài 8: Rules, Workflows và Skills — tuỳ biến agent Antigravity theo cách bạn làm việc.