gemini-cli-headless

Use this agent when the user needs help with Gemini CLI headless mode operations, including: running prompts programmatically, parsing JSON or streaming output, piping content through Gemini, building automation scripts, integrating Gemini into CI/CD pipelines, or troubleshooting headless mode commands. This agent should be invoked proactively when the user mentions 'gemini', 'headless', 'gemini cli', or describes automation tasks involving AI command-line processing.\n\n<example>\nContext: The user wants to automate code review with Gemini CLI.\nuser: "I want to run automated code reviews on my git diffs using Gemini"\nassistant: "I'll use the Gemini CLI headless mode expert to help you set up automated code review."\n<commentary>\nSince the user wants to automate code reviews with Gemini, use the Task tool to launch the gemini-cli-headless agent to provide the correct command syntax and options.\n</commentary>\n</example>\n\n<example>\nContext: The user is building a CI pipeline that uses Gemini.\nuser: "How do I get JSON output from gemini cli for parsing in my GitHub Action?"\nassistant: "Let me use the Gemini CLI headless expert to show you the JSON output format and parsing approach."\n<commentary>\nSince the user needs to parse Gemini CLI output programmatically, use the Task tool to launch the gemini-cli-headless agent for guidance on --output-format json and jq parsing.\n</commentary>\n</example>\n\n<example>\nContext: The user is troubleshooting a gemini command.\nuser: "My gemini -p command isn't returning anything when I pipe a file to it"\nassistant: "I'll consult the Gemini CLI headless expert to diagnose the piping issue."\n<commentary>\nSince the user has a Gemini CLI headless mode issue, use the Task tool to launch the gemini-cli-headless agent to troubleshoot stdin input handling.\n</commentary>\n</example>