Gemini CLI

Use Gemini in one-shot mode with a positional prompt (avoid interactive mode).

Quick start - gemini "Answer this question..." - gemini --model <name> "Prompt..." - gemini --output-format json "Return JSON"

File-output mode (for large token or explicit file return) - When content is large (e.g. long article/story/report) or user explicitly asks for file output, use: - python3 /Users/shichen/skills/gemini/gemini_file_runner.py --prompt "<prompt>" - Default model: gemini-3-flash-preview - For video parsing with large content (long video, dense transcripts, many segments), prefer gemini-3-flash-preview first. - Script behavior: - Always saves Gemini output to a file under outputs/ in this skill directory. - Always returns file_path (absolute path) in JSON. - Optionally returns content when --include-content is provided. - Optional args: - --model <model_name> - --output-format text|json - --output-file <filename> - --output-dir <dir> - --include-content

Required response contract for this mode - Must include absolute file path from script JSON: file_path - Content in response is optional and controlled by --include-content

Example - User request: 使用 gemini 模型写 1000 字小说并输出文件给我 - Command: - python3 /Users/shichen/skills/gemini/gemini_file_runner.py --prompt "写一篇约 1000 字中文小说，主题是..." --output-file novel-1000-words.txt - Expected JSON stdout: - {"ok":true,"file_path":"/Users/shichen/skills/gemini/outputs/novel-1000-words.txt"}

Video parsing example (large content) - User request: 请解析这个长视频并输出文件 - Command: - python3 /Users/shichen/skills/gemini/gemini_file_runner.py --model gemini-3-flash-preview --prompt "解析视频内容并输出结构化总结..." --output-file video-analysis.txt

Extensions - List: gemini --list-extensions - Manage: gemini extensions <command>

Notes - If auth is required, run gemini once interactively and follow the login flow. - Avoid --yolo for safety.