Sains & Teknologi

Cara Menggunakan Google Antigravity CLI: Perintah, Prompt, dan Workflow Aman

Cara Menggunakan Google Antigravity CLI: Perintah, Prompt, dan Workflow Aman

Cara Menggunakan Google Antigravity CLI: Perintah, Prompt, dan Workflow Aman

Google Antigravity CLI adalah antarmuka terminal untuk menjalankan AI coding agent langsung di dalam folder proyek. Dengan CLI ini, developer dapat meminta AI membaca codebase, membuat rencana, menulis kode, menjalankan pengujian, dan membantu memperbaiki error.

Google Antigravity CLI cocok untuk pengguna yang terbiasa bekerja dengan terminal, Git, server Linux, SSH, dan workflow pengembangan tanpa aplikasi grafis.

Artikel ini membahas cara menjalankan Google Antigravity CLI, perintah dasar, contoh prompt, workflow Git, serta tips agar perubahan kode tetap aman.

Apa Itu Google Antigravity CLI?

Google Antigravity CLI adalah versi terminal dari platform Google Antigravity. Perintah utama yang digunakan adalah agy.

Melalui CLI, agent dapat:

  • Membaca struktur folder proyek.
  • Menganalisis kode.
  • Membuat rencana pekerjaan.
  • Mengubah beberapa file.
  • Menjalankan perintah terminal.
  • Menulis dan menjalankan pengujian.
  • Menjelaskan error pada aplikasi.
  • Melanjutkan sesi pekerjaan sebelumnya.

Persiapan Sebelum Menggunakan CLI

Sebelum menjalankan Google Antigravity CLI, pastikan Anda sudah:

  • Menginstal Antigravity CLI.
  • Memiliki akun atau metode autentikasi yang sesuai.
  • Membuka terminal baru setelah instalasi.
  • Memiliki folder proyek yang dapat dibaca.
  • Menggunakan Git atau backup untuk menyimpan perubahan.

Jika belum menginstalnya, baca panduan cara install Google Antigravity di Windows, macOS, dan Linux.

Perintah Dasar Google Antigravity CLI

1. Menjalankan Antigravity

Masuk ke folder proyek, lalu jalankan:

agy

Perintah ini membuka antarmuka terminal interaktif Google Antigravity.

2. Menjalankan dengan Prompt Awal

Anda dapat memberikan instruksi sejak awal menggunakan opsi -i:

agy -i "Analisis struktur proyek ini dan jelaskan fungsi setiap folder"

3. Menjalankan Prompt Sekali Jalan

Untuk tugas sederhana, gunakan opsi -p:

agy -p "Jelaskan fungsi file utama pada proyek ini"

4. Melihat Penggunaan Kuota

Gunakan perintah berikut untuk memeriksa penggunaan model atau kredit:

/usage

5. Menjadwalkan Tugas

Google Antigravity CLI menyediakan perintah /schedule untuk tugas sekali jalan atau tugas yang dijalankan secara berkala:

/schedule

Gunakan fitur ini dengan hati-hati, terutama jika tugas memiliki izin untuk mengubah file atau menjalankan perintah.

6. Menggunakan Browser Agent

Jika workflow membutuhkan pemeriksaan halaman web atau pengujian antarmuka, gunakan:

/browser

7. Menjalankan Tugas Sampai Selesai

Untuk instruksi yang sudah jelas dan memiliki tujuan akhir, Anda dapat menggunakan:

/goal

Sebaiknya gunakan perintah ini hanya pada proyek yang sudah memiliki backup dan batasan izin yang jelas.

8. Keluar dari Sesi

Untuk mengakhiri sesi CLI, gunakan:

/exit

Contoh Prompt Google Antigravity CLI

Analisis Proyek

Analisis struktur proyek ini.
Jelaskan framework yang digunakan.
Jangan mengubah file apa pun.

Membuat Fitur Baru

Tambahkan fitur pencarian pada halaman daftar produk.
Buat rencana terlebih dahulu.
Jangan mengubah kode sebelum saya menyetujui rencana.

Memperbaiki Error

Jalankan pengujian yang tersedia.
Cari penyebab error.
Tampilkan rencana perbaikan sebelum mengubah file.

Membuat Pengujian

Buat unit test untuk fungsi validasi email.
Gunakan framework test yang sudah dipakai proyek ini.
Jalankan test setelah selesai.

Workflow Aman Menggunakan Google Antigravity CLI

1. Buat Branch Git

git checkout -b eksperimen-antigravity

Dengan branch terpisah, perubahan dari agent tidak langsung memengaruhi branch utama.

2. Periksa Status Repository

git status

Pastikan tidak ada perubahan penting yang belum disimpan sebelum memberikan tugas kepada agent.

3. Minta Agent Membuat Rencana

Jangan langsung meminta agent menulis kode. Mulai dengan instruksi seperti:

Baca kebutuhan proyek ini dan buat rencana perubahan.
Jangan menjalankan perintah dan jangan mengubah file.

4. Tinjau Perubahan

Setelah agent selesai bekerja, periksa file yang berubah:

git diff

5. Jalankan Pengujian

Sesuaikan perintah dengan teknologi proyek:

npm test

Atau untuk proyek Python:

pytest

6. Commit Setelah Verifikasi

git add .
git commit -m "Perubahan dari workflow Antigravity"

Jangan melakukan commit sebelum memahami seluruh perubahan yang dibuat oleh agent.

Contoh Workflow untuk Proyek PHP

Untuk proyek PHP, Anda dapat memberikan prompt berikut:

Analisis proyek PHP ini.
Identifikasi controller dan model yang berkaitan dengan autentikasi.
Jangan mengubah file.
Tampilkan potensi masalah keamanan yang ditemukan.

Setelah rencana disetujui, Anda dapat melanjutkan:

Perbaiki validasi login sesuai rencana.
Gunakan prepared statement.
Jangan menampilkan password atau data sensitif pada log.
Jalankan pengujian setelah perubahan.

Contoh Workflow untuk Proyek JavaScript

Periksa halaman dashboard JavaScript ini.
Cari error pada pemanggilan API.
Buat perbaikan dengan perubahan seminimal mungkin.
Tambahkan pengujian untuk kondisi error.

Selalu pastikan agent mengikuti struktur dan library yang sudah digunakan oleh proyek.

Cara Menggunakan Google Antigravity CLI di Server

Google Antigravity CLI dapat digunakan pada server atau lingkungan remote, tetapi sebaiknya tidak langsung diberikan akses penuh ke server produksi.

Workflow yang lebih aman:

  1. Gunakan server staging.
  2. Buat user khusus untuk pekerjaan agent.
  3. Batasi izin folder.
  4. Jangan menyimpan API key di repository.
  5. Gunakan SSH key dengan izin minimal.
  6. Periksa setiap perintah sebelum dijalankan.
  7. Deploy ke produksi hanya setelah review manual.

Tips Membuat Prompt yang Lebih Akurat

  • Jelaskan tujuan akhir secara spesifik.
  • Sebutkan file atau folder yang boleh diubah.
  • Jelaskan file yang tidak boleh disentuh.
  • Sebutkan framework dan versi jika relevan.
  • Minta agent membuat rencana sebelum eksekusi.
  • Minta pengujian setelah perubahan.
  • Tentukan format hasil yang diinginkan.

Contoh prompt yang lebih baik:

Perbaiki validasi formulir pada file resources/views/login.blade.php.
Gunakan pola validasi yang sudah ada.
Jangan mengubah database migration.
Buat ringkasan perubahan dan jalankan test terkait.

Masalah yang Sering Terjadi

Perintah agy Tidak Ditemukan

Tutup dan buka kembali terminal. Jika masih gagal, periksa apakah lokasi binary CLI sudah masuk ke PATH.

Agent Tidak Dapat Membaca Folder

Pastikan Anda menjalankan agy dari folder proyek yang benar dan telah mengonfirmasi workspace tersebut aman.

Perubahan Terlalu Banyak

Gunakan instruksi dengan batasan file dan minta agent mengubah satu bagian kecil terlebih dahulu.

Pengujian Gagal

Minta agent menjelaskan error, tetapi jangan langsung meminta perubahan otomatis pada semua file. Periksa penyebabnya melalui diff dan log.

Keamanan Saat Menggunakan CLI

  • Jangan menyalin file .env ke dalam prompt.
  • Jangan memberikan token akses ke agent.
  • Gunakan repository non-produksi untuk eksperimen.
  • Periksa perintah shell sebelum menyetujuinya.
  • Jangan menggunakan opsi yang melewati konfirmasi keamanan tanpa memahami risikonya.
  • Simpan backup sebelum refactoring besar.

Kesimpulan

Google Antigravity CLI membantu developer menggunakan AI coding agent langsung dari terminal. Perintah agy dapat digunakan untuk membuka sesi interaktif, sedangkan opsi -i dan -p membantu menjalankan prompt awal atau tugas sekali jalan.

Workflow terbaik adalah meminta agent membuat rencana, menggunakan branch Git terpisah, memeriksa diff, menjalankan pengujian, lalu melakukan commit setelah perubahan dipastikan aman.

Untuk memahami perbedaan Google Antigravity dengan tool lain, baca juga artikel Google Antigravity vs Cursor vs Claude Code.

FAQ Google Antigravity CLI

Apa perintah untuk menjalankan Google Antigravity CLI?

Perintah utamanya adalah agy. Jalankan dari folder proyek yang ingin dianalisis atau dikembangkan.

Apakah Google Antigravity CLI bisa digunakan di Linux?

Ya. CLI dapat digunakan pada macOS, Linux, dan Windows melalui metode instalasi yang disediakan pada dokumentasi resmi.

Apakah Google Antigravity CLI dapat mengubah banyak file?

Ya, tetapi perubahan multi-file perlu diperiksa melalui Git diff sebelum diterapkan ke branch utama.

Apakah Google Antigravity CLI aman untuk server produksi?

Gunakan dengan sangat hati-hati. Sebaiknya gunakan staging, akun dengan izin terbatas, dan lakukan review sebelum deployment ke produksi.

Apakah Google Antigravity CLI bisa menjalankan pengujian?

Ya. Agent dapat membantu menjalankan perintah pengujian yang tersedia pada proyek, selama izin menjalankan perintah diberikan.