@ikyyofc/gemini-cli 2.0.6 → 2.0.8

package/README.md

@@ -3,17 +3,28 @@
 > 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*.
+
 ---
 
-## Instalasi
+## 📚 Dokumentasi Lengkap
+
+Untuk detail lebih lanjut mengenai arsitektur dan fitur spesifik, silakan baca dokumentasi berikut:
+
+- [**Architecture Overview**](./docs/ARCHITECTURE.md) - Penjelasan tentang ReAct loop dan cara kerja agent.
+- [**API Reference**](./docs/API.md) - Referensi fungsi utama (`callGemini`, `chat`).
+- [**Tools (Function Calling)**](./docs/TOOLS.md) - Daftar lengkap tool yang tersedia untuk agent (baca file, jalankan shell, dll).
+- [**Extensions System**](./docs/EXTENSIONS.md) - Cara membuat dan mengelola ekstensi serta custom commands.
+- [**Memory & Context**](./docs/MEMORY.md) - Panduan menggunakan `GEMINI.md` untuk memberikan konteks pada agent.
+
+---
+
+## 🚀 Instalasi
 
 ```bash
 npm install
@@ -23,118 +34,73 @@ npm link    # optional: pakai sebagai `gemini` di terminal
 
 ---
 
-## Penggunaan
+## 💻 Penggunaan
+
+Anda dapat menggunakan Gemini CLI dalam mode interaktif (REPL) atau mode *one-shot* langsung dari terminal.
 
 ```bash
-gemini                                    # interactive agent
-gemini "buatkan REST API di ./api"        # one-shot
-gemini --system "Kamu senior backend engineer"
-gemini --file ./app.js "jelaskan kode ini"
-gemini --yolo "refactor semua file di src/"
-gemini --chat                             # plain chat tanpa tools
+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)
 ```
 
----
-
-## GEMINI.md — Context Files
+### Interactive Commands
 
-Buat `GEMINI.md` di lokasi berikut (dimuat hierarki, seperti Gemini CLI asli):
+Saat berada di dalam mode interaktif, Anda dapat menggunakan perintah berikut:
 
-| Lokasi | Scope |
-|--------|-------|
-| `~/.gemini/GEMINI.md` | Global semua project |
-| `./GEMINI.md` | Project root (sampai `.git`) |
-
-Support import antar file:
-```md
-@./components/style.md
-@../shared/conventions.md
-```
-
-**Commands:**
 ```
-/memory show          → tampilkan semua context yang dimuat
-/memory reload        → reload dari disk
-/memory add <text>    → append ke ~/.gemini/GEMINI.md
+/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
 ```
 
 ---
 
-## Extensions
-
-Manifest: `~/.gemini/extensions/<name>/gemini-extension.json`
-
-```json
-{
-  "name": "my-ext",
-  "version": "1.0.0",
-  "description": "...",
-  "contextFileName": "GEMINI.md",
-  "enabled": true,
-  "commands": {
-    "do-thing": {
-      "description": "Does a thing",
-      "prompt": "Do this: {{args}}"
-    }
-  }
-}
-```
+## 🧠 Fitur Utama
 
-**Commands:**
-```
-/ext list
-/ext install /path/to/ext
-/ext install https://github.com/user/repo
-/ext uninstall <name>
-/ext enable / disable <name>
-/ext update <name>
-```
-
-Custom commands dipanggil: `/code-reviewer:review ./src/app.js`
+### 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](./docs/TOOLS.md).
 
----
+### 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](./docs/MEMORY.md).
 
-## Tools (Native Function Calling)
-
-| Tool | Aksi |
-|------|------|
-| `read_file` | Baca file |
-| `write_file` | Tulis/overwrite file |
-| `patch_file` | Edit bagian spesifik |
-| `append_file` | Append ke file |
-| `list_dir` | List direktori |
-| `find_files` | Cari file (glob) |
-| `search_in_files` | Grep dalam file |
-| `run_shell` | Jalankan shell command |
-| `create_dir` | Buat direktori |
-| `delete_file` | Hapus file |
-| `move_file` | Pindah/rename |
-| `get_env` | Info environment |
-| `read_url` | Fetch URL / API |
+### 3. Extension System
+Perluas kemampuan CLI dengan membuat ekstensi yang berisi custom commands dan konteks tambahan. [Baca selengkapnya](./docs/EXTENSIONS.md).
 
 ---
 
-## Struktur
+## 📂 Struktur Direktori
 
 ```
 gemini-cli/
 ├── index.js                   ← CLI entry + REPL + commands
-├── GEMINI.md                  ← Project context (auto-loaded)
 ├── 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
-└── extensions/
-    └── code-reviewer/
-        ├── gemini-extension.json
-        └── GEMINI.md
-
-~/.gemini/                     ← Global config dir
-├── GEMINI.md
-├── extensions/
-└── commands/
-```
+│   ├── 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
+```

package/index.js

@@ -22,11 +22,14 @@ import {
     PasteTransform, restorePaste,
     enableBracketedPaste, disableBracketedPaste
 } from "./src/input.js";
+import { setupGlobalProxy, proxyStatus, setProxyEnabled } from "./src/utils/proxy.js";
+import { Spinner } from "./src/utils/spinner.js";
 
 // ─────────────────────────────────────────────────────────────────
 //  Bootstrap
 // ─────────────────────────────────────────────────────────────────
 ensureGlobalDir();
+setupGlobalProxy();   // aktifkan rotasi proxy sebelum request apapun
 
 let extensions    = loadExtensions();
 let memoryLoaded  = [];
@@ -81,13 +84,20 @@ function cleanup() {
     disableBracketedPaste();
     try { if (process.stdin.isTTY) process.stdin.setRawMode(false); } catch {}
 }
-process.on("exit", cleanup);
+process.on("exit",    cleanup);
 process.on("SIGTERM", () => { cleanup(); process.exit(0); });
 
+// When terminal is resized (or focus returns on some terminals),
+// only redraw prompt if we are NOT currently processing
+process.on("SIGWINCH", () => { if (!processing) showPrompt(); });
+
 // ─────────────────────────────────────────────────────────────────
 //  Prompt
 // ─────────────────────────────────────────────────────────────────
 function showPrompt() {
+    // Never redraw prompt while a request is in flight
+    if (processing) return;
+
     const mode  = agentMode     ? chalk.hex("#4EC9B0")("agent") : chalk.dim("chat");
     const yolo  = autoApprove   ? chalk.red(" yolo")   : "";
     const file  = pendingFile   ? chalk.yellow(` +${path.basename(pendingPath)}`) : "";
@@ -127,29 +137,25 @@ async function send(rawLine) {
         const res = await runAgentLoop(userText, history, {
             systemInstruction: sysInstruction(),
             autoApprove,
-            maxIterations: 5000,
         });
         if (res?.finalResponse) {
             history.push({ role: "user",      content: userText });
             history.push({ role: "assistant", content: res.finalResponse });
         }
     } else {
-        const { default: ora } = await import("ora");
-        const sp = ora({
-            text: "thinking…", spinner: "dots", color: "cyan",
-            prefixText: "  ", discardStdin: false
-        }).start();
+        const sp   = new Spinner();
         const msgs = [];
         if (sysInstruction()) msgs.push({ role: "system", content: sysInstruction() });
         msgs.push(...history, { role: "user", content: userText });
+        sp.start("thinking…", "#4A9EFF");
         try {
             const t0    = Date.now();
             const reply = await chat(msgs, pendingFile || null);
-            sp.succeed(chalk.dim(`done (${((Date.now()-t0)/1000).toFixed(1)}s)`));
+            sp.succeed(`done  ${((Date.now()-t0)/1000).toFixed(1)}s`);
             history.push({ role: "user", content: userText }, { role: "assistant", content: reply });
             printAssistant(reply);
         } catch (e) {
-            sp.fail("failed");
+            sp.fail(e.message);
             printError(e.message);
         }
     }
@@ -275,13 +281,35 @@ async function handleCommand(input) {
             catch (e) { printError(e.message); }
             break;
 
-        case "/model":
+        case "/model": {
+            const px = proxyStatus();
             printInfo(`model      gemini-pro-latest`);
             printInfo(`tools      ${agentMode ? "on (native function calling)" : "off"}`);
             printInfo(`yolo       ${autoApprove ? "on" : "off"}`);
             printInfo(`memory     ${memoryLoaded.length} file(s)  ·  extensions: ${extensions.length}`);
+            printInfo(`proxy      ${px.available}/${px.total} available  ·  ${px.blocked} blocked  ·  ${px.enabled ? "on" : "off"}`);
             printInfo(`config     ${GLOBAL_DIR}`);
             break;
+        }
+
+        case "/proxy": {
+            const px = proxyStatus();
+            const sub = tokens[1];
+            if (sub === "off") {
+                setProxyEnabled(false);
+                printInfo("proxy rotation off — direct connection");
+            } else if (sub === "on") {
+                setProxyEnabled(true);
+                printSuccess("proxy rotation on");
+            } else {
+                // Show status
+                printInfo(`status     ${px.enabled ? "on" : "off"}`);
+                printInfo(`available  ${px.available} / ${px.total}`);
+                printInfo(`blocked    ${px.blocked} (auto-unblock setelah 15 menit)`);
+                printInfo(`usage      /proxy on | /proxy off`);
+            }
+            break;
+        }
 
         case "/exit": case "/quit":
             cleanup(); console.log(""); process.exit(0); break;

package/package.json

@@ -1,25 +1,15 @@
 {
   "name": "@ikyyofc/gemini-cli",
-  "version": "2.0.6",
-  "description": "AI CLI Agent powered by Gemini — your own terminal assistant",
+  "version": "2.0.8",
+  "description": "AI Agent CLI — native function calling · GEMINI.md context · extensions",
   "type": "module",
-  "main": "index.js",
-  "bin": {
-    "gemini": "./index.js"
-  },
-  "scripts": {
-    "start": "node index.js",
-    "dev": "node --watch index.js"
-  },
+  "bin": { "gemini": "./index.js" },
+  "scripts": { "start": "node index.js" },
   "dependencies": {
     "axios": "^1.7.9",
     "chalk": "^5.3.0",
-    "cli-spinners": "^2.9.2",
     "file-type": "^19.6.0",
     "ora": "^8.1.1",
-    "readline": "^1.3.0",
-    "marked": "^12.0.0",
-    "marked-terminal": "^7.1.0",
-    "minimist": "^1.2.8"
+    "toml": "^3.0.0"
   }
-}
+}

package/src/agent.js

@@ -1,117 +1,136 @@
-// src/agent.js — ReAct agent loop using NATIVE Gemini function calling
+// src/agent.js — ReAct agent loop, native Gemini function calling
 import chalk from "chalk";
-import ora   from "ora";
-import { callGemini }   from "./gemini.js";
-import { GEMINI_TOOLS, executeTool } from "./tools.js";
-import { printAssistant, printError, printWarning, printToolCall, printToolResult } from "./renderer.js";
-
-/**
- * Run the agent loop until the model gives a final text answer (no more tool calls).
- *
- * Native function calling flow:
- *   1. Send contents + tools (functionDeclarations) to Gemini
- *   2. Response parts may contain: { functionCall: { name, args } }
- *   3. Execute the tool → get result
- *   4. Append model turn (with functionCall) + user turn (with functionResponse)
- *   5. Repeat until response has only text parts → done
- */
+import { callGemini } from "./gemini.js";
+import { GEMINI_TOOLS, FUNCTION_DECLARATIONS, executeTool } from "./tools.js";
+import { Spinner } from "./utils/spinner.js";
+import {
+    printAssistant, printError, printWarning,
+    printToolCall, printToolResult,
+    printStepHeader, printStepFooter,
+} from "./renderer.js";
+
+const TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+
+// ─────────────────────────────────────────────────────────────────
+//  System prompt
+// ─────────────────────────────────────────────────────────────────
+function buildSystemPrompt(extra = "") {
+    const toolList = FUNCTION_DECLARATIONS.map(t => `- ${t.name}: ${t.description}`).join("\n");
+    return `You are an autonomous AI coding agent running in the user's terminal. You have full access to their filesystem and shell through tools.
+
+## CORE RULE — NEVER ASK, ALWAYS ACT
+
+You MUST use tools to complete tasks. You are NEVER allowed to:
+- Ask the user to run a command themselves
+- Ask the user to write or edit any code themselves
+- Say "you can run...", "try running...", "create a file...", "add this code to..."
+- Give instructions instead of taking action
+
+If you need to run something → use run_shell.
+If you need to read a file → use read_file first.
+If you need to create/edit a file → use write_file or patch_file.
+If something fails → diagnose and retry automatically, never ask user.
+
+## WORKFLOW
+1. EXPLORE — read existing structure/files before acting
+2. ACT — use tools to complete the task fully
+3. VERIFY — run/test after changes to confirm it works
+4. REPORT — brief summary of what was done
+
+## TOOLS
+${toolList}
+
+## RULES
+- Always read files before editing them
+- Use patch_file for targeted edits (safer than full rewrite)
+- Verify code works by running it after changes
+- If a command fails, fix it yourself and retry
+- Only ask the user if the request is genuinely ambiguous
+- Current working directory: ${process.cwd()}
+- Platform: ${process.platform}
+
+${extra ? `## EXTRA INSTRUCTIONS\n${extra}` : ""}`.trim();
+}
+
+// ─────────────────────────────────────────────────────────────────
+//  Agent loop
+// ─────────────────────────────────────────────────────────────────
 export async function runAgentLoop(userMessage, history, {
     systemInstruction = null,
     autoApprove       = false,
-    maxIterations     = 5000,
 } = {}) {
 
-    // Build initial message list
-    const messages = [
-        ...history,
-        { role: "user", content: userMessage }
-    ];
+    const fullSystem = buildSystemPrompt(systemInstruction ?? "");
+    const messages   = [...history, { role: "user", content: userMessage }];
+    const spinner    = new Spinner();
+    const deadline   = Date.now() + TIMEOUT_MS;
+    let   iteration  = 0;
 
-    let iteration = 0;
+    while (true) {
+        if (Date.now() > deadline) {
+            spinner.stop();
+            printWarning("timeout: 10 menit tercapai, agent dihentikan");
+            return { finalResponse: null, iterations: iteration };
+        }
 
-    while (iteration < maxIterations) {
         iteration++;
 
-        // ── Call Gemini API with tools ──────────────────────────
-        const spinner = ora({
-            text:         chalk.dim(iteration === 1 ? "thinking…" : `step ${iteration}…`),
-            spinner:      "dots",
-            color:        "cyan",
-            prefixText:   "  ",
-            discardStdin: false,   // prevent ora from pausing stdin after stop
-        }).start();
+        // ── Animated spinner while waiting for LLM ─────────────────
+        spinner.start(
+            iteration === 1 ? "thinking…" : `thinking… (step ${iteration})`,
+            "#4A9EFF"
+        );
 
         let parts;
         try {
-            const res = await callGemini({ messages, tools: GEMINI_TOOLS, systemInstruction });
+            const res = await callGemini({ messages, tools: GEMINI_TOOLS, systemInstruction: fullSystem });
             parts = res.parts;
-            spinner.stop();
-            clearLine();
+            spinner.stop(); // clear line silently
         } catch (err) {
-            spinner.fail(chalk.hex("#F44747")("API error"));
+            spinner.fail(err.message);
             printError(err.message);
-            printError(JSON.stringify(err.response.data, null, 2));
             return null;
         }
 
-        // ── Separate text parts from functionCall parts ─────────
-        const textParts = parts.filter(p => p.text != null);
-        const callParts = parts.filter(p => p.functionCall != null);
-
-        // Print any accompanying text (model thinking aloud)
+        const textParts   = parts.filter(p => p.text        != null);
+        const callParts   = parts.filter(p => p.functionCall != null);
         const textContent = textParts.map(p => p.text).join("").trim();
-        if (textContent && callParts.length > 0) {
-            process.stdout.write(
-                chalk.dim("  …  " + textContent.replace(/\n/g, "\n       ")) + "\n"
-            );
-        }
 
-        // ── No tool calls → final answer ────────────────────────
+        // ── Final answer — no more tool calls ─────────────────────
         if (callParts.length === 0) {
-            const final = textParts.map(p => p.text).join("").trim();
-            // Close the tool section if it was opened
-            if (iteration > 1) {
-                process.stdout.write(
-                    chalk.hex("#4A9EFF")("  ╰") +
-                    chalk.hex("#555566")("─".repeat(47)) + "\n"
-                );
-            }
-            if (final) printAssistant(final);
-            return { finalResponse: final, iterations: iteration };
+            if (textContent) printAssistant(textContent);
+            return { finalResponse: textContent, iterations: iteration };
         }
 
-        // ── Execute each tool call ───────────────────────────────
-        messages.push({ role: "model", parts });
-
-        // Print tool section header on first iteration
-        if (iteration === 1) {
+        // ── Model reasoning text (before tool block) ───────────────
+        if (textContent) {
             process.stdout.write(
-                "\n" + chalk.hex("#4A9EFF")("  ╭─ working") +
-                chalk.hex("#555566")(" " + "─".repeat(36)) + "\n"
+                chalk.hex("#4A4A5E")("  ┄ ") +
+                chalk.hex("#7A7A9A").italic(textContent.split("\n")[0].slice(0, 72)) +
+                "\n"
             );
         }
 
-        const responseParts = [];
+        // ── Step block — fresh per iteration ──────────────────────
+        printStepHeader(iteration);
+        messages.push({ role: "model", parts });
 
+        const responseParts = [];
         for (const part of callParts) {
             const { name, args } = part.functionCall;
-            printToolCall(name, args);
+
+            // Animate the tool name while it runs
+            spinner.start(name + "…", "#FFD080");
+            printToolCall(name, args ?? {});
+            spinner.stop();
 
             const result = await executeTool(name, args ?? {}, { autoApprove });
             printToolResult(result);
 
-            responseParts.push({
-                functionResponse: { name, response: result }
-            });
+            responseParts.push({ functionResponse: { name, response: result } });
         }
 
+        printStepFooter();
         messages.push({ role: "user", parts: responseParts });
     }
-
-    printWarning(`Max iterations (${maxIterations}) reached.`);
-    return { finalResponse: null, iterations: iteration };
-}
-
-function clearLine() {
-    if (process.stdout.clearLine) { process.stdout.clearLine(0); process.stdout.cursorTo(0); }
 }

package/src/extensions.js

@@ -67,7 +67,7 @@ export function getExtensionContextDirs(extensions) {
     return extensions.map(e => e.path);
 }
 
-/** Build all custom commands from: extensions + ~/.gemini/commands/**  */
+/** Build all custom commands from extensions + ~/.gemini/commands/**  */
 export async function loadCustomCommands(extensions) {
     const cmds = {};   // "namespace:name" → { description, prompt, source }
 
@@ -192,4 +192,4 @@ export async function updateExtension(name) {
     } catch (e) {
         return { error: e.message };
     }
-}
+}