oh-my-gemini

Sister projects: oh-my-claudecode (OMC) | oh-my-codex (OMX)

Multi-agent orchestration for Gemini CLI. Zero learning curve.

Quick Start | Team Mode | Commands | Docs

Quick Start

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

After setup, restart Gemini CLI for /omg:* commands to appear.

omg doctor                                    # check prerequisites
omg team run --task "..." --workers 2         # parallel work
omg hud --watch                               # live status

Team Mode

tmux-first multi-worker orchestration with persistent state and lifecycle controls.

omg team run --task "review src/ for reliability gaps" --workers 4
omg team status --team oh-my-gemini --json
omg team resume --team oh-my-gemini
omg team shutdown --team oh-my-gemini --force

Default backend: tmux | Optional: subagents for role-tagged runs

Commands

CLI

| Command | Description | |---------|-------------| | omg | Launch Gemini CLI with OMG extension | | omg team run | Start orchestrated team run | | omg team status/resume/shutdown/cancel | Team lifecycle | | omg doctor | Diagnose prerequisites | | omg verify | Run validation suites | | omg hud | Live team status overlay | | omg skill | List/print reusable skill prompts |

Slash Commands (inside Gemini CLI)

| Command | Description | |---------|-------------| | /omg:autopilot | End-to-end autonomous execution | | /omg:plan | Phased execution plan with gates | | /omg:execute | Immediate task implementation | | /omg:review | Structured code review | | /omg:verify | Acceptance validation | | /omg:debug | Root cause investigation | | /omg:status | Progress summary | | /omg:cancel | Graceful stop | | /omg:handoff | Context transfer document |

Full command reference: docs/omg/commands.md

Requirements

• Node.js 20+
• Gemini CLI
• tmux (brew install tmux / apt install tmux)

Default Models (Gemini 3.1)

| Tier | Model | Context | |------|-------|---------| | HIGH | gemini-3.1-pro-preview | 1M | | MEDIUM | gemini-3.1-flash-lite-preview | 1M | | LOW | gemini-3.1-flash-lite-preview | 1M |

omg launch 시 기본 모델은 gemini-3.1-flash-lite-preview. omg --pro로 3.1 Pro 강제 선택 가능.

Override with OMG_MODEL_HIGH, OMG_MODEL_MEDIUM, OMG_MODEL_LOW env vars. Gemini 3 and 2.5 models remain available for backward compatibility.

License

MIT

oh-my-claudecode | oh-my-codex