{
  "markdown": "# Oh My Gem (OMG)\n## OMO for Gemini CLI\n\n**Oh My Gem** is a high-fidelity port of the **Oh My OpenCode (OMO)** agent orchestration system to the Gemini CLI. It transforms the standard Gemini session into a professional software engineering team with 12 specialized agents, surgical safety protocols, and robust lifecycle hooks.\n\n---\n\n## Origin and Attribution\n\nOh My Gem is a faithful Gemini CLI port of **Oh My OpenAgent / Oh My OpenCode** by YeonGyu Kim.\n\nThe goal of this project is to bring the same agent-harness philosophy and workflow model to Gemini CLI, while adapting the implementation to Gemini CLI's different extension architecture.\n\nThis repository contains substantial portions adapted from the original project and is therefore distributed under the same Sustainable Use License 1.0 (SUL-1.0).\n\nFull credit for the original concept and core implementation goes to YeonGyu Kim and the Oh My OpenAgent project.\n\n---\n\n## Requirements\n\n- Gemini CLI installed\n- Git installed\n- Python 3 available on PATH\n- Optional: `CONTEXT7_API_KEY` for higher Context7 rate limits\n- Optional: `tmux` for persistent terminal session support\n\n---\n\n## 🚀 Quick Start\n\n1. **Install Extension**:\n   ```bash\n   gemini extensions install https://github.com/pangelini777/oh-my-gem\n   ```\n2. **Initialize Workspace**:\n   ```bash\n   /doctor\n   ```\n3. **Start Working**:\n   ```bash\n   /ultrawork \"implement a new auth system\"\n   ```\n\nFor local development from a cloned checkout, use:\n\n```bash\ngemini extensions link .\n```\n\nor install a local copy with:\n\n```bash\ngemini extensions install .\n```\n\n---\n\n## Uninstall\n\n```bash\ngemini extensions uninstall oh-my-gem\n```\n\n---\n\n## 🤖 The Team (Agents)\n\n| Agent | Role | Model |\n| :--- | :--- | :--- |\n| **SISYPHUS** | Main Orchestrator & Project Manager | `gemini-3.1-pro-preview` |\n| **PROMETHEUS** | Strategic Planner (Interview Mode) | `gemini-3.1-pro-preview` |\n| **HEPHAESTUS** | Autonomous Code Maker (TDD) | `Dynamic (via Model Router)` |\n| **ORACLE** | Technical Lead & Architect | `gemini-3.1-pro-preview` |\n| **METIS** | Plan Consultant & Gap Finder | `gemini-3.1-pro-preview` |\n| **MOMUS** | Ruthless Judge & Reviewer | `gemini-3.1-pro-preview` |\n| **EXPLORE** | Fast Scout & Code Search | `gemini-3-flash-preview` |\n| **LIBRARIAN** | Doc & GitHub Code Researcher | `gemini-3-flash-preview` |\n| **ATLAS** | Taskboard Manager & State Keeper | `gemini-3-flash-preview` |\n| **LOOKER** | Vision & UI/UX Analyzer | `gemini-3-flash-preview` |\n| **GENERALIST** | Batch Worker & Cleanup | `gemini-3-flash-preview` |\n| **SISYPHUS-JR** | Agile Assistant & Quick Edits | `gemini-3-flash-preview` |\n\n> 💡 **Research Strategy**: The Librarian uses a \"Three-Pillar\" strategy (Context7, GitHub/Grep.app, and Web Search) to provide evidence-based answers. To enable higher rate limits, set the `CONTEXT7_API_KEY` in your environment.\n\n---\n\n## 🛡️ Surgical Safety (Hashline-Edit)\n\nOh My Gem implements the **OMO Hashline Protocol**. Every file read injects content-addressed hashes (`LINE#HASH|`). \n\n**The Guard**: The `replace` tool is wrapped in a hook that verifies these hashes. If a file changes on disk after the agent reads it, the hook **blocks** the edit, preventing code corruption and stale-line errors.\n\n## 🔐 Policy Notes\n\nGemini CLI ignores `allow` decisions contributed by extensions. Oh My Gem only ships extension-safe deny rules; if you want permanent allow rules, add them to your user policy files under `~/.gemini/policies/`.\n\n## Security Notes\n\nOh My Gem installs lifecycle hooks and MCP server configurations. Review `hooks/hooks.json`, `policies/`, and `gemini-extension.json` before installation.\n\n---\n\n## 🔗 Lifecycle Hooks\n\n*   **Model Router**: Dynamically selects models based on intent (3.1 Pro for reasoning/fix/evaluation, 3 Flash for implementation/efficiency).\n*   **Agent Status**: Uses `systemMessage` to inject professional UI banners indicating agent state.\n*   **Intent Gate**: Classifies user requests (Research/Fix/Impl) and enforces verbalization.\n*   **Todo Enforcer**: Monitors the Taskboard Ledger for stagnation and triggers reassessment if tasks remain un-updated.\n*   **Ralph Loop**: Detects missing `<promise>DONE</promise>` and triggers autonomous continuation.\n*   **Output Truncator**: Dynamically chops tool outputs (40k for web, 150k default) to save context.\n*   **Error Recovery**: Injects actionable suggestions when JSON or Edit tools fail.\n*   **Tmux Manager**: Ensures a persistent `oh-my-gem` terminal session is always available.\n*   **Codebase Mapper**: Generates structural intelligence for the agents.\n\n---\n\n## 🛠️ Custom Commands\n\n- `/ultrawork <task>`: Fully autonomous end-to-end execution.\n- `/doctor`: Workspace health and configuration diagnostics.\n\n---\n\n## 📁 Structure\n\n```\n.\n├── .gemini/\n│   ├── agents/      # 12 Agent definitions (.md)\n│   ├── hooks/       # Python logic scripts (.py)\n│   ├── commands/    # Custom slash commands (.toml)\n│   └── policies/    # Extension-safe deny rules\n├── .oh-my-gem/      # Workspace ledger\n│   └── taskboard.md\n└── GEMINI.md        # Workspace instructions\n```\n\n💡 **Tip**: Keep `.oh-my-gem/taskboard.md` open in your IDE to watch the Sisyphus team update your project ledger in real-time.\n",
  "bytes": 5229,
  "sha": "de895d852d7fb39f48090604608586704eae5b3c5470de7e9ec71a85a3f6a45f",
  "repo_slug": "pangelini777/oh-my-gem",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_pangelini777_oh_my_gem_cb2b04c1/readme"
}