Gemini CLI Cheatsheet

• Gemini CLI มี free tier สำหรับผู้ใช้ Google account ส่วนบุคคล
• รองรับ non-interactive scripting โดยตรงผ่าน -p
• รองรับ --output-format json และ stream-json สำหรับ automation
• รองรับ Google Search grounding, file operations, shell commands และ web fetch
• รองรับ MCP servers และ custom commands อย่างเป็นทางการ
• มี GEMINI.md สำหรับ project context โดยตรง

• เด่นเรื่อง Extensions อย่างเป็นทางการ ทำให้สามารถแพ็ก capabilities, commands และ integrations เป็นหน่วยแจกจ่ายได้ชัด
• มี browser_agent แบบ built-in ใน docs สำหรับ browser automation ผ่าน accessibility tree โดยตรง ซึ่งไม่ใช่ทุกตัวมีเป็น built-in agent
• มีระบบ @{...}, !{...}, {{args}} ใน custom commands ชัดและ practical มากสำหรับ prompt templating
• รองรับทั้ง Google account sign-in, Gemini API key และ Vertex AI ทำให้เหมาะกับทั้งสายบุคคลและสาย enterprise บน Google Cloud
• มี free tier และเชื่อม ecosystem ของ Google ได้ดี เช่น Search grounding และ tooling ฝั่ง Google

Built-in Subagents จาก docs

วิธีเรียก

• automatic delegation: main agent จะเลือกเรียกเองถ้างานตรงกับความเชี่ยวชาญ
• บังคับด้วย @subagent_name ที่ต้น prompt เช่น @codebase_investigator ...
• จัดการผ่าน /agents

วิธีเรียก Subagent ชัดๆ

หลักสำคัญจาก docs:

• ถ้าขึ้นต้น prompt ด้วย @subagent_name Gemini จะใส่ system note เพื่อบังคับ route ไปหาตัวนั้น
• subagent มี context และ toolset แยกจาก main agent
• subagent ใน Gemini ไม่สามารถเรียก subagent อื่นต่อซ้อนกันได้

คำสั่ง /agents ที่ docs ระบุ

Custom Subagent Files

ตัวอย่างจาก docs:

---
name: security-auditor
description: Specialized in finding security vulnerabilities in code.
kind: local
tools:
  - read_file
  - grep_search
model: gemini-3-flash-preview
temperature: 0.2
max_turns: 10
---
You are a ruthless Security Auditor.

File Locations

ชื่อ command

• ~/.gemini/commands/test.toml -> /test
• <project>/.gemini/commands/git/commit.toml -> /git:commit

โครง .toml

description = "Generates a Git commit message based on staged changes."
prompt = """Please generate a Conventional Commit message based on the staged diff below:

!{git diff --staged}
"""

Placeholder / Syntax ที่ docs รองรับ

วิธีเรียก Custom Command ชัดๆ

Extensions

• Gemini CLI มีระบบ Extensions อย่างเป็นทางการ
• จัดการผ่าน /extensions
• คำสั่งสำคัญ เช่น install, link, list, enable, disable, update

📂 Workspace & Context

⚙️ System & Settings

💾 Session Management

การดึงข้อมูลจากแหล่งต่างๆ เข้ามาใน Prompt:

• Local Files: @src/app.tsx (ระบุไฟล์) หรือ @lib/ (ทั้งโฟลเดอร์)
• Git Context: @git:staged (เฉพาะที่แอดไว้), @git:diff (ที่ยังไม่ commit)
• Web Content: @https://github.com/... (ดึงโค้ดจากเว็บ)
• Filtered Search: @src/**/*.ts (ระบุ pattern ของไฟล์)
• Clipboard: @clip (ดึงข้อมูลล่าสุดจาก clipboard)

Gemini CLI รองรับ MCP เพื่อขยายขีดความสามารถ:

• เชื่อมต่อ Database: ให้ AI คิวรีข้อมูลจาก SQL/NoSQL ได้โดยตรง
• เชื่อมต่อ API: ดึงข้อมูลจาก Slack, Google Search, Brave Search
• Local Tools: ให้ AI รัน Script ในเครื่องเพื่อจัดการไฟล์ซับซ้อน

# ตัวอย่างการเพิ่ม MCP Server
gemini mcp add sqlite-reader --command "npx" --args "-y, @modelcontextprotocol/server-sqlite"

1) CI/CD Debugger

gemini "รัน !npm test ถ้า error ให้ดู @logs/error.log แล้วแก้โค้ดใน @src/ ให้ผ่าน"

2) Documentation Generator

gemini "สแกนโค้ดใน @src/ ทั้งหมด แล้วเขียน README.md ให้ละเอียดตามมาตรฐานใน @GEMINI.md"

3) Code Refactor (Step-by-Step)

gemini /plan "ช่วยเปลี่ยน @lib/old-api.ts เป็น @lib/new-api.ts โดยอ้างอิงจาก @docs/api-v2.md"

4) JSON Automation Output

gemini -p "สรุป architecture ของ repo นี้" --output-format json

5) Stream Events สำหรับ long-running job

gemini -p "รัน test และสรุป failure" --output-format stream-json

1. Check Status: gemini /stats ดูยอด Token คงเหลือ
2. Sync Context: /init เพื่ออัปเดตความเข้าใจของ AI ต่อโปรเจกต์
3. Work: พัฒนาฟีเจอร์โดยใช้ @file และรันเทสด้วย !npm test
4. Review: /plan ก่อนเริ่มงานใหญ่ เพื่อลดความผิดพลาด
5. Save: /chat save "feature-x-done" เพื่อเก็บเป็นประวัติ