v1.x
⌨️ Keyboard Shortcuts
Basic Controls
Submit prompt
Enter
Cancel / close overlay
Esc
Interrupt running task
Ctrl+C
Exit Gemini CLI
Ctrl+D
Clear screen
Ctrl+L
Suspend to background
Ctrl+Z
Input
Insert newline
Shift+Enter
Insert newline (alt)
⌥+Enter
Insert newline (alt)
Alt+Enter
Paste multi-line text
Ctrl+V
Open external editor ($EDITOR)
Ctrl+E
History
Search history
Ctrl+R
Previous entry
Ctrl+P / ↑
Next entry
Ctrl+N / ↓
Clear input
Esc Esc
🎛️ App Controls
Mode & UI Toggles
Cycle approval mode
Shift+Tab
Toggle YOLO mode
Ctrl+Y
Toggle todos panel
Ctrl+T
Toggle markdown rendering
Alt+M
Expand/collapse output
Ctrl+O
Background Shell
Open background shell
Ctrl+B
Kill background task
Ctrl+K
List background tasks
Ctrl+J
Text Editing
Beginning of line
Ctrl+A
End of line
Ctrl+E
Kill to end of line
Ctrl+K
Kill to beginning of line
Ctrl+U
Kill previous word
Ctrl+W
Undo / Redo
⌘+Z / ⌘+Shift+Z
Undo / Redo
Ctrl+Z / Ctrl+Y
⚡ Interactive Commands
Reload Commands
/reload skills
/reload agents
/reload commands
/reload memory
/reload mcp
/reload extensions
Session Commands
Show help & all slash commands
/help
Quit session
/quit
Reload memory files
/memory reload
List MCP servers & tools
/mcp
Prompt Prefixes
/ — invoke a slash command
! — run a shell command inline
@ — reference a file (autocomplete)
🖥️ CLI Commands & Flags
Core
gemini — start interactive REPL
-p "prompt" — one-shot non-interactive
-i — stay interactive after -p
-r — resume last session
gemini update — update CLI to latest
Pipe Input
cat file.txt | gemini -p "summarize"
cat file.txt | gemini -p "summarize"
Get-Content file.txt | gemini -p "summarize"
Key Flags
-m flash — choose model/alias
-o out.txt — write output to file
--approval-mode yolo
-w — git worktree mode experimental
-s name — named session
-d — debug / verbose output
--list-sessions — show saved sessions
--delete-session id
--include-directories — include dirs in context
-e KEY=VAL — env var override
--allowed-mcp-server-names a,b
🤖 Model Selection
Alias → Model ID
AliasResolves to
auto gemini-2.5-pro (auto-select)
pro gemini-2.5-pro
flash gemini-2.5-flash
flash-lite gemini-2.0-flash-lite
Approval Modes
Ask before every actiondefault
Auto-approve file editsauto_edit
Plan first, then executeplan
Auto-approve everythingyolo
Shift+Tab cycles approval mode in the REPL
Examples
gemini -m flash -p "explain this"
gemini --approval-mode auto_edit
📁 Memory & Context
GEMINI.md Locations
Project (workspace)./GEMINI.md
Global (user)~/.gemini/GEMINI.md
Workspace GEMINI.md takes precedence over user-level
Config File Paths
User settings~/.gemini/settings.json
Project settings.gemini/settings.json
Keybindings~/.gemini/keybindings.json
Ignore patterns.geminiignore
Context Controls
Reload memory in session/memory reload
Reference file in prompt@filename
Auto-compression settingmodel.compressionThreshold
Autocomplete triggers on @ — fuzzy-matches files in workspace
🔌 MCP Servers
Add Server
gemini mcp add name cmd [args]
gemini mcp add --transport http name url
gemini mcp add --env KEY=VAL name cmd
gemini mcp add --scope user|project name cmd
gemini mcp add --include-tools t1,t2 name cmd
Manage
gemini mcp remove name
gemini mcp list
In Session
Show connected servers + tools/mcp
Reload MCP servers/reload mcp
Limit servers at launch--allowed-mcp-server-names
🧩 Extensions
Install & Remove
gemini extensions install name
gemini extensions install --ref branch name
gemini extensions install --auto-update name
gemini extensions uninstall name
Manage
gemini extensions list
gemini extensions update name
gemini extensions update --all
gemini extensions enable name
gemini extensions disable name
Dev Commands
gemini extensions link ./local-path
gemini extensions new name
gemini extensions validate
Reload in session/reload extensions
🤹 Skills & Agents
Skills CLI
gemini skills list
gemini skills install name
gemini skills link ./local-path
gemini skills uninstall name
gemini skills enable name
gemini skills disable name
gemini skills enable --all
In Session
Reload skills/reload skills
Reload agents/reload agents
Config Keys
Enable/disable all skillsskills.enabled
Max turns per sessionmodel.maxSessionTurns
Git Worktrees experimental
Requires -w flag + experimental.worktrees: true in settings
gemini -w "refactor auth module"
⚙️ Key Settings
General
Vim keybindings in inputvimMode
Default approval modedefaultApprovalMode
Auto-update on startenableAutoUpdate
System notifications macOS only enableNotifications
Model
Model name or aliasmodel.name
Context compression thresholdmodel.compressionThreshold
Max turns per sessionmodel.maxSessionTurns
Security
Disable YOLO modedisableYoloMode
Disable always-allow actionsdisableAlwaysAllow
Sandbox tool executionsandbox
Example ~/.gemini/settings.json
{
  "model": "flash",
  "defaultApprovalMode": "auto_edit",
  "vimMode": true,
  "enableAutoUpdate": true
}