1. Pengantar
Dalam codelab ini, Anda akan mempelajari Antigravity CLI, sebuah antarmuka pengguna Terminal (TUI) ringan dari Antigravity. Gemini CLI menghadirkan kemampuan agen inti yang sama seperti Antigravity (seperti penalaran multi-langkah, pengeditan multi-file, panggilan alat, dan histori percakapan) langsung ke terminal Anda.
Yang akan Anda pelajari
- Menginstal dan mengonfigurasi Antigravity CLI
- Memahami penggunaan dasar Antigravity CLI
- Mengeksplorasi beberapa kasus penggunaan dengan Antigravity CLI
Yang Anda butuhkan
Anda akan memerlukan hal berikut:
- Browser web Chrome
- Akun Gmail pribadi
Codelab ini dirancang untuk pengguna dan developer dari semua tingkat keahlian (termasuk pemula). Kasus penggunaan dalam codelab telah dikategorikan ke dalam tugas developer dan non-developer. Kasus penggunaan developer menunjukkan cara memadukan kode dengan Antigravity CLI dan bekerja dengan repositori GitHub untuk melakukan tugas pengembangan umum seperti penjelasan/pemahaman kode, pembuatan dokumentasi, perbaikan masalah, dan lainnya. Sebaiknya Anda menyelesaikan kasus penggunaan ini di codelab. Ada bagian opsional di akhir yang mencakup beberapa tugas sehari-hari yang tidak berfokus pada developer.
2. Penginstalan
Sebelum Anda melakukan penyiapan dan menjalankan Antigravity CLI, mari kita buat folder yang akan kita gunakan sebagai folder utama untuk semua project yang kita buat di dalamnya. Ini adalah titik awal bagi Antigravity CLI untuk mulai bekerja, meskipun juga akan merujuk ke beberapa folder lain di sistem Anda yang akan Anda pelajari nanti, sesuai kebutuhan.
Lanjutkan dan buat folder contoh (agy-cli-projects) lalu buka folder tersebut melalui perintah yang ditunjukkan di bawah. Jika Anda lebih suka menggunakan nama folder lain, silakan lakukan.
mkdir agy-cli-projects
Buka folder tersebut:
cd agy-cli-projects
Penginstalannya mudah dan biner tersedia di seluruh Sistem Operasi utama. Saya telah mengambil perintah untuk dijalankan di terminal langsung dari dokumen penginstalan:
macOS | Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
CMD Windows
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
Idealnya, perintah ini akan menyiapkan dan menginstal Antigravity CLI (agy) di sistem Anda dan di Path.
Dalam beberapa kasus, jika penginstal tidak dapat menambahkan program biner ( agy ke jalur), penginstal akan memberi tahu. Misalnya, berikut adalah contoh output di komputer, tempat penginstal tidak dapat menambahkan program biner ke jalur dan menyarankan apa yang harus dilakukan.
% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
Cukup periksa versi Antigravity CLI melalui perintah berikut (versi yang ditampilkan adalah versi pada saat penulisan codelab ini):
$ agy --version
1.0.7
Saat kita meluncurkan Antigravity CLI untuk pertama kalinya, Anda akan diminta untuk login. Luncurkan agy dan akan muncul tampilan yang mirip dengan ini:
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to the Antigravity CLI. You are currently not signed in.
Select login method:
> 1. Google OAuth
2. Use a Google Cloud project
[Use arrow keys to navigate, Enter to select]
Gunakan akun pribadi Anda untuk saat ini. Pilih 1. Google OAuth, lalu tekan Enter. Tindakan ini akan meluncurkan browser dan Anda dapat login dengan Akun Google Anda. Setelah autentikasi dan otorisasi berhasil, Anda akan diminta untuk menyalin kode. Kembali ke terminal Antigravity CLI dan tempelkan kode.
Setelah login berhasil, beberapa hal akan terjadi:
- Pertama, Anda akan ditanya tentang tema warna yang ingin Anda pilih untuk Antigravity CLI, seperti yang ditunjukkan di bawah. Pilih salah satu yang Anda sukai.
- Selanjutnya, Anda harus menyetujui beberapa persyaratan layanan. Terima saja.
Terakhir, yang paling penting adalah memberikan izin bahwa Anda memercayai folder tersebut, seperti yang ditunjukkan di bawah:
Accessing workspace:
/Users/yourusername/agy-cli-projects
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm
Anda akan melihatnya biasanya di folder baru tempat Anda meluncurkan Antigravity CLI. Kita akan membahasnya lebih lanjut nanti dalam seri ini, tetapi untuk saat ini, lanjutkan dan klik Yes, I trust this folder.
Selamat! Anda sudah siap dan Antigravity CLI sedang menunggu perintah Anda.
3. Interaksi pertama kita dengan Antigravity CLI
Mari mulai menggunakan Antigravity CLI dan ketik kueri pertama Anda seperti yang ditunjukkan di bawah ini:
Give me a famous quote on Artificial Intelligence and who said that?
Kita akan mendapatkan contoh respons seperti yang ditunjukkan di bawah:
Here is a famous quote on Artificial Intelligence:
│ "Artificial intelligence is the new electricity."
│ — Andrew Ng
Selain memberikan perintah di sini, apa saja berbagai perintah yang didukung Antigravity CLI? Anda dapat menemukannya dengan mengetik /help (garis miring). Anda akan melihat 3 tab : umum, perintah, dan pintasan. Secara default, Anda akan membuka tab general dan dapat menggunakan tombol tab untuk membuka commands, tempat Anda akan melihat berbagai perintah. Anda juga dapat membuka pintasan keyboard.
Daftar perintah pada saat penulisan ditampilkan di bawah:
Catatan: Anda dapat keluar dari Antigravity CLI kapan saja melalui perintah /quit atau Anda dapat melakukan ctrl+d dua kali dalam sesi terminal Antigravity CLI interaktif.
4. Antigravity CLI - beberapa perintah penting
Pastikan Antigravity CLI telah berjalan dan menunggu perintah Anda. Jika Anda telah mencoba perintah /quit di akhir bagian sebelumnya, luncurkan kembali Antigravity CLI melalui perintah agy.
Perhatikan model yang digunakannya, yang namanya akan ditampilkan di kanan bawah. Hal pertama yang ideal adalah memahami bahwa sebagian besar penyesuaian dan setelan yang perlu Anda lakukan tersedia melalui perintah /config atau /settings.
Konfigurasi / Setelan
Lanjutkan dan panggil perintah /config. Tindakan ini akan memunculkan berbagai area Antigravity yang dapat Anda sesuaikan berdasarkan preferensi Anda. Hal ini mencakup Skema Warna, izin Alat, setelan telemetri, dan lainnya.
Settings
Search:
────────────────────
> Animation Speed medium
Artifact Review asks for review
Color Scheme dark
Editor auto ($EDITOR)
Enable Telemetry on
Non-Workspace Access off
Notifications off
Rendering Mode native terminal (inline)
Sandbox Mode off
Show Feedback Survey on
Show Tips on
Tool Permission request-review
Use AI Credits off
Verbosity high
Misalnya, Skema Warna menampilkan opsi berikut, yang dapat saya gunakan untuk memilih skema warna pilihan saya:
settings.json
Setelan konfigurasi harus disimpan di suatu tempat, bukan? Semuanya disimpan dalam file ~/.gemini/antigravity-cli/settings.json. Contohnya ditampilkan di bawah ini:
{
"colorScheme": "dark",
"model": "Gemini 3.5 Flash (High)",
"statusLine": {
"type": "",
"command": "",
"enabled": true
},
"trustedWorkspaces": [
"/Users/romin/antigravity-cli-projects",
"/Users/romin/agy-cli-projects"
]
}
Anda dapat melihat colorScheme yang telah saya pilih, model, dan berbagai folder tempat saya memulai Antigravity CLI dan menyetujui untuk memercayai folder tersebut.
Catatan: Anda juga dapat mengubah settings.json secara langsung dan memulai ulang Antigravity CLI sebagai praktik terbaik untuk melihat perubahan. Namun, pastikan setelannya benar, jika tidak, error akan ditampilkan saat startup. Jika tidak ingin mengubah file secara langsung, sebaiknya gunakan perintah /settings atau /config di Antigravity CLI untuk menggunakan file ini.
Izin Alat
Setelan penting yang harus dipahami adalah Izin Alat. Setelan ini mengontrol apakah perintah terminal memerlukan persetujuan Anda sebelum dijalankan. Anda dapat mengaksesnya melalui perintah /config.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
Secara default, nilainya ditetapkan ke request-review. Mari kita pahami hal ini secara lebih mendetail. Di Antigravity, setelan Izin Alat mengontrol keseimbangan antara keamanan (melindungi sistem host Anda dari perubahan yang tidak diinginkan) dan kecepatan (seberapa otonom agen dapat bekerja tanpa jeda untuk menunggu input Anda). Mari kita tinjau opsi berikut:
request-review (Default Saat Ini)
Dalam mode ini, agen diperlakukan sebagai partner kolaboratif yang melakukan check-in sebelum melakukan tindakan apa pun yang dapat memengaruhi sistem atau file project Anda di luar batas yang telah disetujui sebelumnya. Setiap kali agen mencoba menjalankan perintah terminal, melakukan operasi file (seperti menulis/menghapus), atau memanggil layanan eksternal yang izinnya belum disetujui sebelumnya, eksekusi akan dijeda. Pengguna diminta untuk menyetujui atau menolak tindakan tertentu.
proceed-in-sandbox
Mode ini memungkinkan agen menjalankan perintah terminal secara otomatis, tetapi dalam container yang aman dan terisolasi. Agen dapat menjalankan perintah tanpa meminta Anda, tetapi perintah tersebut dijalankan di sandbox virtual (misalnya, container ringan). Perintah tersebut tidak dapat mengubah sistem file mesin host Anda yang sebenarnya atau mengakses jaringan lokal Anda.
always-proceed
Ini adalah mode yang sepenuhnya otonom, yang memberikan kecepatan dan kemampuan maksimum kepada agen. Agen diberi izin penuh untuk menjalankan perintah dan menulis file langsung di mesin host Anda. Fitur ini tidak akan pernah meminta konfirmasi Anda.
ketat
Ini adalah mode zero-trust dengan keamanan tinggi. Kemampuan agen dibatasi untuk menjalankan alat baca. Semua alat non-baca akan mengharuskan pengguna diminta untuk melakukan tindakan.
5. Antigravity CLI - Parameter Perintah
Ada beberapa parameter command line yang dapat diberikan saat Anda memulai Antigravity CLI. Untuk mendapatkan daftar lengkap opsi, Anda dapat menggunakan --help seperti yang ditunjukkan di bawah.
agy --help
Tindakan ini akan menampilkan berbagai opsi yang tersedia. Contoh listingan ditampilkan di bawah:
Mari kita lihat beberapa di antaranya.
Mode non-interaktif (otomatis)
Yang menarik, kita bisa menjalankan Antigravity CLI dalam mode non-interaktif. Artinya, Anda langsung memberikan perintah dan Antigravity akan langsung meresponsnya, tanpa membuka terminal interaktif Antigravity CLI. Hal ini sangat berguna jika Anda berencana menggunakan Antigravity CLI secara otomatis sebagai bagian dari skrip atau proses otomatisasi lainnya.
Anda menggunakan parameter -p untuk memberikan perintah ke Antigravity CLI seperti yang ditunjukkan di bawah:
agy -p "What is the gcloud command to deploy to Cloud Run"
Cara ini mungkin merupakan cara yang baik untuk mendapatkan beberapa jawaban cepat, tetapi perlu diingat bahwa tidak ada kesempatan untuk melanjutkan percakapan dengan pertanyaan lanjutan.
Memilih model tertentu
Yang pertama adalah meminta Antigravity CLI menggunakan mode Gemini tertentu. Anda dapat menggunakan parameter --model untuk memberi tahu Antigravity CLI agar menggunakan model tertentu hanya selama sesinya. Hal ini sangat berguna untuk mode non-interaktif yang kami sebutkan di bagian sebelumnya, tempat Anda ingin meluncurkan beberapa sesi agy dan menggunakan model tertentu untuk tugas tertentu.
Namun, pertama-tama Anda perlu mengetahui model mana yang tersedia untuk Antigravity CLI. Anda dapat melakukannya melalui subperintah models seperti yang ditunjukkan di bawah:
agy models
Perintah ini akan mencantumkan model yang tersedia untuk Antigravity CLI. Contoh daftar ditampilkan di bawah:
- Gemini 3.5 Flash (Sedang)
- Gemini 3.5 Flash (Tinggi)
- Gemini 3.5 Flash (Rendah)
- Gemini 3.1 Pro (Rendah)
- Gemini 3.1 Pro (Tinggi)
- Claude Sonnet 4.6 (Berpikir)
- Claude Opus 4.6 (Berpikir)
- GPT-OSS 120B (Sedang)
Anda dapat menggunakan salah satu nama model ini untuk menentukan model yang akan digunakan untuk sesi. Anda dapat melakukannya melalui perintah --model yang ditunjukkan di bawah:
agy --model "Gemini 3.5 Flash (Low)"
Setelah Antigravity CLI diluncurkan, Anda dapat memeriksa melalui perintah /model tentang model tertentu yang Anda minta untuk digunakan atau melihat di kanan bawah yang menampilkan model yang digunakan untuk sesi tersebut.
Hidup dalam bahaya
Jika Anda suka mengambil risiko, Anda dapat mencari parameter yang dinamai dengan sangat tepat, yaitu --dangerously-skip-permissions. Tindakan ini akan menyetujui semua izin alat secara otomatis. Tidak akan ada dialog yang meminta izin Anda. Jadi, gunakan dengan hati-hati.
Luncurkan Antigravity CLI melalui perintah berikut:
agy --dangerously-skip-permissions
Kemudian, berikan perintah berikut. Periksa apakah aplikasi tidak meminta izin tulis file apa pun kepada saya.
> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.
● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)
▸ Thought for 2s, 95 tokens
Processing News Information
● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)
I have fetched the latest world news headlines and created the requested files in your workspace:
1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S.
security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.
2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.
Mode ini dapat berguna dalam skenario saat semuanya bersifat lokal dan di bawah kendali Anda, tetapi tetap bersiaplah untuk kejutan dan gunakan dengan hati-hati.
6. Antigravity CLI - Mode shell
Sekarang adalah waktu yang tepat untuk mempelajari cara bekerja langsung dengan Shell dari dalam Antigravity CLI. Anda dapat masuk ke mode shell dengan menekan ! di kotak pesan. Tindakan ini akan mengaktifkan mode Shell. Anda dapat kembali dengan menekan ! lagi atau dengan menekan tombol ESC.
Saat dalam mode shell, Anda akan melihat ! di awal perintah seperti yang ditunjukkan di bawah:
Anda dapat langsung memeriksa menggunakan perintah standar seperti pwd dan ls. Perhatikan bahwa perintah mengasumsikan OS jenis Linux. Jika Anda menggunakan sistem operasi lain (Windows), gunakan perintah yang setara seperti (cd, dir, dan type).
7. Kasus penggunaan yang dapat dicoba
Antigravity CLI dapat diterapkan ke berbagai kasus penggunaan yang berlaku untuk developer dan non-developer. Berikut beberapa skenario dan bergantung pada area minat Anda, Anda dapat mencoba salah satu atau semuanya.
Dalam setiap kasus ini, perintah disediakan. Anda dapat mencobanya dalam mode interaktif Antigravity CLI untuk lebih memahami cara Antigravity CLI menjalankan tugasnya.
Vibe coding dengan Antigravity CLI
Mari kita gunakan Antigravity CLI untuk melakukan vibe coding pada aplikasi. Dalam tugas ini, Anda akan meminta Antigravity CLI untuk membuat aplikasi, lalu mengirim versi awal ke repositori GitHub.
Prasyarat
Untuk melakukan tugas di bagian ini, ada beberapa prasyarat:
- Git
- Antigravity CLI
- Lingkungan Python 3
- Siapkan
gh( alat GitHub CLI). - Pemahaman tentang dasar-dasar Git dan sedikit pengetahuan pemrograman
Kami akan mengasumsikan bahwa Anda telah meluncurkan Antigravity CLI di folder tertentu pilihan Anda. Dalam kasus ini, kita telah meluncurkan Antigravity CLI dari folder beranda awal : agy-cli-projects dan folder lain bq-releases-notes di dalamnya.
Mulai dengan perintah awal. Anggap ini sebagai spesifikasi untuk aplikasi Anda. Jangan ragu untuk memodifikasinya sesuai keinginan Anda. Perlu diingat bahwa selama sesi dengan Antigravity CLI, Anda akan diminta izin untuk membuat file, dll. Berikan izin yang diperlukan.
Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me.
A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details.
I would also like the ability to take any specific update,