English | Korean | Chinese | Japanese

oh-my-gemini

姐妹项目： 更喜欢 Claude Code 或 Codex？请查看 oh-my-claudecode (OMC) 和 oh-my-codex (OMX)。

为 Gemini CLI 提供多智能体编排。零学习成本。

别再折腾 Gemini CLI。直接运行 OMG。

快速开始 • 团队模式 • 功能 • CLI 参考 • 环境要求

快速开始

第 1 步：安装

npm install -g oh-my-gemini-sisyphus

第 2 步：设置

omg setup --scope project

omg setup 现在也会为当前安装自动注册 OMG Gemini 扩展。

第 3 步：启动 Gemini

omg

就是这么简单。

omg 会在加载 OMG 扩展的情况下启动 Gemini CLI。如果你已经在 tmux 中，它会直接在当前环境运行；如果不在，OMG 会为你启动一个新的 tmux 会话。

接下来可以尝试的命令

omg doctor
omg verify
omg hud --watch

安装方式

通过 npm 安装（CLI + Extension）

npm install -g oh-my-gemini-sisyphus
omg setup --scope project

omg setup 会应用本地设置文件，并自动将 oh-my-gemini 注册为 Gemini CLI 扩展。

通过 Gemini Extension 安装（仅扩展）

gemini extensions install github:jjongguet/oh-my-gemini

这种方式会直接安装扩展。若要使用 omg team run、omg doctor、omg verify 等完整 CLI 功能，还需要全局安装 npm 包。

团队模式（推荐）

OMG 以 tmux 为先：omg team run 会协调真实的 Gemini 驱动 worker 会话，将状态持久化到 .omg/state/ 下，并为长时间运行的工作提供生命周期命令。

# 并行实现或审查
omg team run --task "review src/team and src/cli for reliability gaps" --workers 4

# 通过任务前缀关键字进行显式后端/角色路由
omg team run --task "/subagents $planner /review /verify ship the release checklist" --workers 3

# 查看或恢复现有运行
omg team status --team oh-my-gemini --json
omg team resume --team oh-my-gemini --max-fix-loop 1

# 完成后优雅关闭
omg team shutdown --team oh-my-gemini --force

默认后端： tmux
可选后端： 用于显式角色标签运行的 subagents

为什么选择 oh-my-gemini？

• Gemini 原生工作流 - 围绕 Gemini CLI 构建，而不是把 Gemini 当作次要提供方硬塞进去
• 零学习曲线入口 - omg 直接启动交互式会话，无需记忆扩展配置细节
• 团队优先编排 - 具备持久化生命周期状态和可恢复运行的协同 worker 执行
• 以验证为门槛的交付 - omg verify 将 typecheck、smoke、integration、reliability 测试打包在一起
• 运维可见性 - HUD、doctor 和有状态生命周期命令让运行状态可观测、可恢复
• 技能感知运行时 - deep-interview、review、verify、handoff 等可复用技能可同时用于 CLI 和扩展优先工作流
• OMC / OMX 家族的一部分 - 作为 OMC（Claude Code）和 OMX（Codex）的 Gemini 兄弟项目，专为 Gemini-first 工作流而调整

功能

编排模式

| 功能 | 它是什么 | 适用场景 | | ------- | ---------- | ---------- | | Team | 具备持久化状态、健康检查、resume/shutdown/cancel 控制，并以 tmux 作为默认运行时的多 worker 编排 | 并行实现、代码审查和长时间协同任务 | | Interactive Launch | omg / omg launch 会在当前 tmux pane 或新的 tmux 会话中，加载 OMG 扩展后启动 Gemini CLI | 无需反复配置的日常交互式 Gemini 开发 | | Verify | omg verify 运行跨 typecheck、smoke、integration、reliability 的打包验证层级 | 发布前检查、可信度门槛、适合 CI 的验证 | | HUD | omg hud 根据持久化团队状态渲染实时状态覆盖层 | 无需翻找 JSON 状态文件即可监控活动运行 | | Skills | omg skill 暴露 deep-interview、review、verify、cancel、handoff 等可复用提示 | 可重复工作流、引导式执行、操作者交接 |

更多开发者杠杆

• Doctor 命令：检查 Node、Gemini CLI、tmux、扩展资源以及 .omg/state 的可写性
• 确定性的状态持久化：在 .omg/state 下支持可恢复的编排
• 从包根目录提供的 Gemini 原生扩展打包 与 /omg:* 命名空间命令
• 在需要时提供更深层 Gemini 集成的 可选 MCP/工具接口

魔法关键字

为高级用户准备的可选快捷方式。OMG 仅使用普通 CLI 命令也能很好地工作。

| 关键字 / 快捷方式 | 效果 | 示例 | | ------------------ | ------ | ------- | | /tmux 或 $tmux | 强制使用 tmux 团队后端 | omg team run --task "/tmux smoke" | | /subagents 或 /agents | 强制使用 subagents 后端 | omg team run --task "/subagents $planner /verify release dry run" --workers 2 | | $planner 或 $plan | 在 subagents 任务开始时分配 planner 角色 | omg team run --task "$planner draft the implementation plan" --workers 1 | | /review | 映射到 code-reviewer 角色 | omg team run --task "/subagents /review inspect auth changes" --workers 1 | | /verify | 映射到 verifier 角色 | omg team run --task "/subagents /verify confirm the gate passes" --workers 1 | | /handoff | 映射到 writer 角色以生成交接产物 | omg team run --task "/subagents /handoff summarize the release state" --workers 1 | | --madmax | 启动 Gemini 时将交互式启动扩展为 --yolo --sandbox=none | omg --madmax |

CLI 参考

| 命令 | 作用 | 示例 | | ------- | ------------ | ------- | | omg | 在加载 OMG 扩展的情况下交互式启动 Gemini CLI | omg | | omg launch | 默认交互式启动命令的显式形式 | omg launch --yolo | | omg team run | 启动新的团队编排运行 | omg team run --task "smoke" --workers 3 | | omg team status | 查看持久化的 phase、worker 和 task 健康状态 | omg team status --team oh-my-gemini --json | | omg team resume | 从持久化元数据恢复之前的运行 | omg team resume --team oh-my-gemini --max-fix-loop 1 | | omg team shutdown | 优雅关闭持久化运行时句柄 | omg team shutdown --team oh-my-gemini --force | | omg team cancel | 将活动任务标记为已取消并停止后续生命周期推进 | omg team cancel --team oh-my-gemini --force --json | | omg doctor | 诊断本地前置条件，并可选择自动修复安全问题 | omg doctor --fix --json | | omg verify | 运行验证套件或分层验证计划 | omg verify --tier thorough | | omg hud | 渲染实时团队 HUD 或持续监视 | omg hud --watch --interval-ms 1000 | | omg skill | 列出或输出可复用技能提示 | omg skill list |

详细命令文档：docs/omg/commands.md

环境要求

必需

• Node.js 20+
• Gemini CLI
• tmux

快速检查：

node -v
gemini --version
tmux -V

tmux 安装提示

| 平台 | 安装方式 | | -------- | ------- | | macOS | brew install tmux | | Ubuntu / Debian | sudo apt install tmux | | Fedora | sudo dnf install tmux | | Arch | sudo pacman -S tmux | | Windows (WSL2) | sudo apt install tmux |

可选

• Docker 或 Podman，用于隔离的 smoke 检查、沙箱实验以及部分贡献者工作流

OMG 不需要 Docker 来完成常规安装、交互式使用或标准团队编排。

许可证

MIT

姐妹项目： oh-my-claudecode • oh-my-codex

Gemini 原生编排。最少仪式感。

Star History

💖 支持这个项目

如果 oh-my-gemini 改善了你的 Gemini CLI 工作流，可以考虑赞助这个项目：

为什么赞助？

• 让 Gemini-first 编排开发持续推进
• 资助团队运行时、HUD 和验证工作流的打磨
• 帮助维护开源文档、技能和运维工具
• 支持 OMG / OMC / OMX 生态系统

其他帮助方式

• ⭐ 给仓库点 Star
• 🐛 报告 Bug
• 💡 提出功能建议
• 📝 贡献代码或文档