Gemini CLI 🤖

AI Agent CLI — native function calling · GEMINI.md context · extension system

  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Gemini CLI  ─  AI Agent  ─  native function calling
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Gemini CLI adalah asisten terminal bertenaga AI yang menggunakan model Gemini dari Google. CLI ini bukan sekadar antarmuka chat biasa, melainkan sebuah AI Agent yang dapat berinteraksi langsung dengan sistem file dan environment lokal Anda menggunakan native function calling.

📚 Dokumentasi Lengkap

Untuk detail lebih lanjut mengenai arsitektur dan fitur spesifik, silakan baca dokumentasi berikut:

• Architecture Overview - Penjelasan tentang ReAct loop dan cara kerja agent.
• API Reference - Referensi fungsi utama (callGemini, chat).
• Tools (Function Calling) - Daftar lengkap tool yang tersedia untuk agent (baca file, jalankan shell, dll).
• Extensions System - Cara membuat dan mengelola ekstensi serta custom commands.
• Memory & Context - Panduan menggunakan GEMINI.md untuk memberikan konteks pada agent.

🚀 Instalasi

npm install
chmod +x index.js
npm link    # optional: pakai sebagai `gemini` di terminal

💻 Penggunaan

Anda dapat menggunakan Gemini CLI dalam mode interaktif (REPL) atau mode one-shot langsung dari terminal.

gemini                                    # Masuk ke mode interactive agent
gemini "buatkan REST API di ./api"        # One-shot task
gemini --system "Kamu senior backend engineer" # Set system prompt
gemini --file ./app.js "jelaskan kode ini"     # Lampirkan file
gemini --yolo "refactor semua file di src/"    # Skip semua konfirmasi tool (HATI-HATI)
gemini --chat                             # Plain chat tanpa tools (bukan agent)

Interactive Commands

Saat berada di dalam mode interaktif, Anda dapat menggunakan perintah berikut:

/agent                 → Toggle agent mode (tools on/off)
/yolo                  → Skip all tool confirmations
/file <path>           → Attach file to next message
/system <text>         → Set system instruction
/history               → Show conversation turns
/export <file>         → Export history to JSON
/cd <path>             → Change working directory
/cwd                   → Show current working directory
/new  /clear           → Reset conversation
/model                 → Show model & config
/help                  → Show help
/exit  /quit           → Exit

🧠 Fitur Utama

1. Native Function Calling (Tools)

Agent dapat membaca file, menulis file, menjalankan perintah shell, dan mencari file secara mandiri untuk menyelesaikan tugas yang Anda berikan. Baca selengkapnya.

2. Hierarchical Context (GEMINI.md)

Anda dapat memberikan instruksi spesifik proyek atau global menggunakan file GEMINI.md. Agent akan memuat konteks ini secara otomatis. Baca selengkapnya.

3. Extension System

Perluas kemampuan CLI dengan membuat ekstensi yang berisi custom commands dan konteks tambahan. Baca selengkapnya.

📂 Struktur Direktori

gemini-cli/
├── index.js                   ← CLI entry + REPL + commands
├── package.json
├── docs/                      ← Dokumentasi lengkap
├── src/
│   ├── gemini.js              ← API client (native function calling)
│   ├── tools.js               ← functionDeclarations + executor
│   ├── agent.js               ← ReAct loop
│   ├── memory.js              ← GEMINI.md hierarchy loader
│   ├── extensions.js          ← Extension manager
│   ├── renderer.js            ← Terminal UI + markdown
│   └── input.js               ← Bracketed paste via Transform stream
└── utils/
    └── proxy-manager.js       ← Global proxy manager

~/.gemini/                     ← Global config dir (dibuat otomatis)
├── GEMINI.md                  ← Global context
├── extensions/                ← Folder instalasi ekstensi
└── commands/                  ← Global custom commands