集成与自动化

Gemini CLI 不只适合在终端聊天。真正落地时，它会进入 IDE、Shell 脚本、CI、GitHub issue、PR review 和本地开发环境。

这一组页面解决“如何把 Gemini CLI 放进工作流”的问题。先选入口，再看权限、输入输出和失败兜底。

学习路径

flowchart LR
    IDE["IDE integration"] --> Hooks["Hooks"]
    Hooks --> Headless["Headless mode"]
    Headless --> Automation["Shell / CI automation"]
    Automation --> GitHub["GitHub Action"]
    GitHub --> IssuePR["Issue / PR automation"]
    IssuePR --> LocalDev["Local development"]
    LocalDev --> Troubleshooting["Troubleshooting"]

    style IDE fill:#dbeafe,stroke:#3b82f6
    style Headless fill:#dcfce7,stroke:#22c55e
    style GitHub fill:#fef3c7,stroke:#f59e0b

IDE + Hooks

人在编辑器里工作时，先看 IDE companion 和 lifecycle hooks。

Headless + Automation

需要脚本化或 CI 调用时，从 headless mode 开始。

GitHub Action

需要 issue、PR、review 自动化时，进入 run-gemini-cli GitHub Action。

页面	适合场景
IDE 集成	需要编辑器上下文、原生 diff、ACP
Hooks	需要在工具调用前后插入校验、阻断或日志
Headless mode	需要非交互式调用 Gemini CLI
自动化脚本	需要把 CLI 放进 Shell、CI 或批处理
GitHub Action	需要在 GitHub workflow 里运行 Gemini CLI
Issue 与 PR 自动化	需要自动分诊 issue、生成回复、辅助 PR review
本地开发	需要贡献 Gemini CLI 或排查 CLI 自身 bug

选择方式

人在 IDE 里工作     IDE companion 或 ACP
需要流程拦截        hooks
需要脚本调用        headless mode
需要 CI 自动处理    run-gemini-cli GitHub Action
需要改 Gemini CLI   本地开发流程

进入前检查

检查项	为什么重要
输入是否可重复	自动化必须能在无人工补充的情况下复跑
输出是否可审计	CI、issue 和 PR 场景要能追踪 Gemini 做了什么
权限是否收窄	hooks、headless、GitHub Action 都可能放大工具权限
失败是否可兜底	自动化失败要回到日志、人工 review 或普通 CLI

下一步

先读：IDE 集成。