Skip to content

installation.md

Latest commit

 

History

History
115 lines (76 loc) · 2.23 KB

installation.md

File metadata and controls

115 lines (76 loc) · 2.23 KB

oh-my-gemini-cli Extension Installation Guide

This guide follows the official Gemini CLI Extensions workflow.

Prerequisites

  1. Gemini CLI installed (recommended v0.31.0+)
  2. Gemini authentication completed
  3. Local clone of this repository

Check quickly:

gemini --version

Compatibility note:

  • If your existing scripts still use --allowed-tools, migrate to --policy profiles.
  • OmG does not require preview-channel-only manifest features to run.
  • OmG now assumes general.previewFeatures=true so Gemini CLI model aliases like pro can resolve to preview-backed models when available.

Step 1: Clone Repository

git clone https://github.com/Joonghyun-Lee-Frieren/oh-my-gemini-cli.git
cd oh-my-gemini-cli

Step 2: Install as Gemini Extension

Run from your terminal (non-interactive mode):

gemini extensions install https://github.com/Joonghyun-Lee-Frieren/oh-my-gemini-cli

Step 3: Verify Extension Loaded

Inside Gemini interactive mode:

/extensions list

Or from terminal:

gemini extensions list

You should see oh-my-gemini-cli in the extension list.

Step 3.5: Enable Preview Features

OmG now defaults to alias-based model routing and expects Gemini CLI preview features to be enabled:

{
  "general": {
    "previewFeatures": true
  }
}

Set this in ~/.gemini/settings.json or your workspace .gemini/settings.json. This repository now ships the workspace setting enabled by default.

Step 4: Verify Core Features

Run one command and one skill:

/omg:status

$plan "Plan a small refactor in this repository"

Optional hook-layer smoke test:

/omg:hooks
/omg:hooks-validate

If agent delegation is needed:

/omg:team "Implement a small feature with planning and review"

If dynamic team composition is needed before execution:

/omg:team-assemble "Analyze competitors and draft a decision report"

Note

No extension-level setting override is required for installation.

Upgrade

  1. Pull latest repository changes.
  2. Restart Gemini CLI.
  3. Re-run gemini extensions list to confirm latest metadata is loaded.

Uninstall

From terminal:

gemini extensions uninstall oh-my-gemini-cli