Gemini CLI 命令行工具：AI代码审查与自动化分析，支持JSON输出与CI/CD集成

gemini-cli by creator-hian/claude-code-plugins

1 周安装量

7 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/creator-hian/claude-code-plugins --skill gemini-cli

AI/机器学习开发运维命令行工具

🇨🇳中文介绍

Gemini CLI 技能

⚠️ 环境注意事项

环境	命令格式
交互式终端	`gemini` (进入交互模式)
Claude Code / CI	`gemini -p "提示词"` (无头模式)
使用 JSON 脚本	`gemini -p "提示词" --output-format json`
标准输入	`echo "提示词"

非 TTY 环境 (Claude Code, CI 流水线) 需要 -p 标志或标准输入。

快速开始

无头模式 (Claude Code/CI)

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

812,900 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

269,400 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

147,400 周安装

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

114,200 周安装

# 基础审查
gemini -p "审查此代码的缺陷"

# 使用 JSON 输出以便解析
gemini -p "分析此代码" --output-format json

# 使用特定模型和目录
gemini -m gemini-3-flash-preview --include-directories ./src,./lib -p "代码分析"

# 使用提示词的标准输入
cat src/auth.py | gemini -p "审查安全问题"

result=$(gemini -p "查询" --output-format json)
response=$(echo "$result" | jq -r '.response')

命令参考 - 斜杠命令、@ 命令、shell 模式
选项参考 - 模型、输出格式、目录、JSON 模式
示例 - 代码审查、CI/CD 集成、自动化脚本

注意：模型名称会随着 Google 发布新版本而改变。运行 gemini --help 或查看 Gemini API 模型获取当前列表。

模型	描述	最适合
`gemini-3-flash-preview`	快速高效 (默认)	标准审查、批量操作、一般用途
`gemini-3.1-pro-preview`	最新旗舰模型	复杂架构分析、安全审计

格式	描述	使用场景
(默认)	人类可读文本	终端输出
`json`	带统计信息的结构化数据	脚本解析、自动化
`stream-json`	JSONL 事件	实时监控

完整模式：参见选项参考

关键字段：response (字符串), stats (对象), error (可选对象)

选项	别名	描述
`--prompt`	`-p`	使用提示词在无头模式下运行
`--model`	`-m`	模型选择
`--output-format`		输出格式 (`json`, `stream-json`)
`--include-directories`		附加上下文目录 (逗号分隔)
`--yolo`	`-y`	自动批准所有操作
`--sandbox`	`-s`	沙盒模式 (`restrictive`)
`--approval-mode`		设置批准模式 (`auto_edit`)

完整示例：参见示例获取详细模式

# 带输出的代码审查
cat src/auth.py | gemini -p "审查安全问题" > review.txt

# 使用 jq 解析的 JSON 输出
result=$(gemini -p "查询" --output-format json)
echo "$result" | jq -r '.response'

# 跨目录分析
gemini --include-directories ./backend,./frontend -p "审查 API 集成"

任务类型	推荐超时时间	Claude Code 工具
快速检查	2 分钟	`timeout: 120000`
标准审查	5 分钟	`timeout: 300000`
深度分析	10 分钟	`timeout: 600000`

建议：对于使用 gemini-3.1-pro-preview 的复杂分析，使用 timeout: 600000。

详细的错误处理模式：参见示例

错误	原因	解决方案
无输出	缺少 `-p` 标志	使用 `gemini -p "提示词"`
空响应	无标准输入/提示词	通过 `-p` 或标准输入提供
退出代码 `1`	一般错误	检查 JSON `.error` 字段
上下文过大	文件过多	使用特定路径
权限被拒绝	沙盒限制	谨慎使用 `--yolo`

在 Claude Code 和 CI 环境中使用 -p 标志
对于脚本解析使用 --output-format json
使用 jq 进行可靠提取
在 JSON 响应中检查 .error 以进行错误处理
对于多目录上下文使用 --include-directories
根据任务匹配模型：大多数任务使用 gemini-3-flash-preview，仅复杂架构/安全分析使用 gemini-3.1-pro-preview
为深度分析设置 10 分钟超时 (timeout: 600000)

🇺🇸English

Gemini CLI Skill

⚠️ Environment Notice

Environment	Command Format
Interactive terminal	`gemini` (enters interactive mode)
Claude Code / CI	`gemini -p "prompt"` (headless mode)
Scripting with JSON	`gemini -p "prompt" --output-format json`
Stdin input	`echo "prompt"

Non-TTY environments (Claude Code, CI pipelines) require -p flag or stdin input.

Quick Start

Headless Mode (Claude Code/CI)

# Basic review
gemini -p "Review this code for bugs"

# With JSON output for parsing
gemini -p "Analyze this code" --output-format json

# With specific model and directories
gemini -m gemini-3-flash-preview --include-directories ./src,./lib -p "Code analysis"

# Stdin input with prompt
cat src/auth.py | gemini -p "Review for security issues"

JSON Output Parsing

result=$(gemini -p "Query" --output-format json)
response=$(echo "$result" | jq -r '.response')

Reference Documentation

Commands Reference - Slash commands, @ commands, shell mode
Options Reference - Models, output formats, directories, JSON schema
Examples - Code review, CI/CD integration, automation scripts

Available Models

Note : Model names change as Google releases new versions. Run gemini --help or check Gemini API Models for the current list.

Model	Description	Best For
`gemini-3-flash-preview`	Fast and efficient (DEFAULT)	Standard reviews, batch operations, general use
`gemini-3.1-pro-preview`	Latest flagship model	Complex architecture analysis, security audits

Output Formats

Format	Description	Use Case
(default)	Human-readable text	Terminal output
`json`	Structured with stats	Script parsing, automation
`stream-json`	JSONL events	Real-time monitoring

JSON Response Structure

Full schema: See Options Reference

Key fields: response (string), stats (object), error (optional object)

Key Options

Option	Alias	Description
`--prompt`	`-p`	Run in headless mode with prompt
`--model`	`-m`	Model selection
`--output-format`		Output format (`json`, `stream-json`)

Common Patterns

Full examples : See Examples for detailed patterns

Essential Patterns

# Code review with output
cat src/auth.py | gemini -p "Review for security issues" > review.txt

# JSON output with jq parsing
result=$(gemini -p "Query" --output-format json)
echo "$result" | jq -r '.response'

# Cross-directory analysis
gemini --include-directories ./backend,./frontend -p "Review API integration"

Timeout Configuration

Task Type	Recommended Timeout	Claude Code Tool
Quick checks	2 minutes	`timeout: 120000`
Standard review	5 minutes	`timeout: 300000`
Deep analysis	10 minutes	`timeout: 600000`

Recommendation : Use timeout: 600000 for complex analysis with gemini-3.1-pro-preview.

Error Handling

Detailed error handling patterns : See Examples

Error	Cause	Solution
No output	Missing `-p` flag	Use `gemini -p "prompt"`
Empty response	No stdin/prompt	Provide via `-p` or stdin
Exit code `1`	General error	Check JSON `.error` field
Context too large	Too many files	Use specific paths
Permission denied	Sandbox restrictions

Best Practices

Use-p flag in Claude Code and CI environments
Use--output-format json for script parsing
Parse withjq for reliable extraction
Check.error in JSON response for error handling
Use--include-directories for multi-directory context
Match model to task : gemini-3-flash-preview for most tasks, gemini-3.1-pro-preview only for complex architecture/security
Set 10-minute timeout for deep analysis (timeout: 600000)

Weekly Installs

Repository

creator-hian/cl…-plugins

GitHub Stars

First Seen

Today

Security Audits

Gen Agent Trust HubFail SocketPass SnykPass

Installed on

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1

Gemini CLI 命令行工具：AI代码审查与自动化分析，支持JSON输出与CI/CD集成

🇨🇳中文介绍

Gemini CLI 技能

⚠️ 环境注意事项

快速开始

无头模式 (Claude Code/CI)

相关 Skills

JSON 输出解析

参考文档

可用模型

输出格式

JSON 响应结构

关键选项

常用模式

基本模式

超时配置

错误处理

最佳实践