whatisgithub

What is oh-my-grok?

iml1s/oh-my-grok — explained in plain English

Analysis updated 2026-05-18

6PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A workflow and orchestration plugin that adds planning, evidence tracking, and verified completion on top of xAI's Grok Build coding CLI.

Mindmap

mindmap
  root((oh-my-grok))
    What it does
      Orchestration layer
      Sits on top of Grok Build
      Tracks evidence and completion
    Tech stack
      Python
      Grok Build CLI
      tmux
    Use cases
      Plan and verify coding tasks
      Coordinate subagents
      Shared multi tool sessions
    Audience
      Developers
      Grok Build users
    Setup
      Clone repo
      Run install script
      Link omg to path

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add structured planning and progress tracking to Grok Build coding sessions.

USE CASE 2

Spawn and coordinate multiple Grok subagents on a single task with verified completion checks.

USE CASE 3

Run a shared tmux session where several AI coding tools work under defined roles.

What is it built with?

PythonGrok BuildtmuxCLI

How does it compare?

iml1s/oh-my-grokaa2246740/ultimate-designaclark4life/home-depot-crawl
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Grok Build CLI and Python 3.11+ already installed before setup.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

So what is it?

Oh-my-grok, shortened to OMG, is a plugin that adds multi-agent orchestration on top of Grok Build, which is xAI's command line tool for coding with the Grok model. It does not replace Grok Build. Instead it sits on top of it and manages the workflow around an agent session: planning, tracking evidence of what was done, and confirming that work is actually finished before it counts as complete. The project has a sibling relationship with similar tools built for other AI coding assistants, including one for Claude Code, one for Codex, and one for a tool called OpenAgent. All of them share the same basic idea of adding a structured workflow layer, but this one is built specifically for Grok's runtime. OMG has two parts working together. The first is a Grok plugin containing skills, agent role prompts, and hooks that plug into Grok's own event system. The second is a command line tool called omg, which tracks run state, records proof that steps were completed, and manages accepting and integrating finished work. A hidden folder in each project.omg, stores plans and progress so the omg tool is the only thing allowed to mark work as passed or verified. Worker agents are spawned only through Grok's own subagent feature, one level deep, rather than through a separate forked runtime. There is also a tmux based host session mode, including an experimental multi pane team setup that can be turned on with an environment variable, letting other coding tools share the same session under role rules. The project is careful to note that this isolation is about ownership of work in progress, not a security sandbox. Installation requires the Grok Build CLI already on the system and Python 3.11 or newer. The recommended setup clones the repository to a stable folder, runs an install script, and links the omg command onto the system path. The project is released under the MIT license and is an independent community project, not made by or affiliated with xAI.

Copy-paste prompts

Prompt 1
Walk me through installing oh-my-grok and wiring it into an existing project with omg setup.
Prompt 2
Explain what the .omg folder stores and why the omg CLI is the only thing allowed to mark a task verified.
Prompt 3
Show me how to use omg's autopilot mode safely on a real coding task.
Prompt 4
What is the difference between the plugin-only install and the full install of oh-my-grok?

Frequently asked questions

What is oh-my-grok?

A workflow and orchestration plugin that adds planning, evidence tracking, and verified completion on top of xAI's Grok Build coding CLI.

What language is oh-my-grok written in?

Mainly Python. The stack also includes Python, Grok Build, tmux.

What license does oh-my-grok use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is oh-my-grok to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is oh-my-grok for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.