@r3dlex/oh-my-gemini

oh-my-gemini

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

Multi-agent orchestration for Gemini CLI with OMG branding and OMP compatibility aliases.

Transition status (2026-04-13): this repo now treats oh-my-gemini / omg as the canonical user-facing surface, with legacy omp / .omp aliases retained only where compatibility still requires them. See docs/analysis/2026-04-13-oh-my-gemini-phase-1-doc-and-quality-review.md for the audited gap list and migration order.

Quick Start | Team Mode | Commands | Docs

Quick Start

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

After setup, restart Gemini CLI for /omg:* commands to appear (/omp:* remains compatible during migration).

The packaged extension now ships a Gemini-native hooks/hooks.json bridge and exposes omg_cli_tools as the canonical MCP server id.

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

Primary CLI launches (omg / omg launch) perform a throttled TTY-only update check (12h cache) and can prompt to run npm install -g oh-my-gemini@latest.
Disable the prompt with OMG_AUTO_UPDATE=0 (compatibility alias: OMP_AUTO_UPDATE=0).

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 the oh-my-gemini extension
omg update	Update the globally installed package immediately
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

Compatibility Note

User-facing command and documentation surfaces now use omg / oh-my-gemini; legacy omp / oh-my-product aliases are treated as compatibility-only shims.

Some internal compatibility identifiers intentionally remain unchanged for now:

• legacy hidden state and artifact paths
• legacy OMP_* compatibility aliases for selected environment variables
• legacy internal interop identifiers
• legacy internal type/class names
• the temporary omp_cli_tools MCP server alias (omg_cli_tools is now the canonical id used by setup and extension manifests)

Those internal names are deferred to a later migration to avoid breaking state, protocol, and compatibility contracts.

Requirements

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

Default Model

Model	Free (OAuth)	Free (API Key)
gemini-3.1-flash-lite-preview (default)	Yes	Yes
gemini-3.1-pro-preview (--pro)	Yes	Yes

Default model on omg launch is gemini-3.1-flash-lite-preview. Use omg --pro for gemini-3.1-pro-preview (omp --pro also works).

All defaults work without a paid Gemini CLI coding plan — just log in via OAuth (Google Account) or use an API key. Override with OMP_MODEL_HIGH, OMP_MODEL_MEDIUM, OMP_MODEL_LOW env vars. Gemini 3.1, 3, and 2.5 models are all available via -m flag.

Emergency Model Override

If a default model becomes unavailable, override immediately without code changes:

export OMP_MODEL_HIGH=<working-model>
export OMP_MODEL_MEDIUM=<working-model>
export OMP_MODEL_LOW=<working-model>

License

MIT

oh-my-claudecode | oh-my-codex