The missing productivity layer for the new Grok Build CLI.
Makes Grok significantly more effective at long-running tasks with proven loops and state management.
grok plugin install github.com/mihazs/oh-my-grok --trust && grok plugin enable oh-my-grokPinned release:
grok plugin install github.com/mihazs/oh-my-grok@v0.1.0 --trustAuthor: mihazs · Repository: https://github.com/mihazs/oh-my-grok
Grok Build CLI launched with a thin plugin ecosystem — no mature “oh-my” productivity layer for long-running agentic work.
oh-my-grok fills that gap: skill gate, Ralph and Ultrawork loops, todo/boulder continuation, handoff, and a unified Stop chain — ported from proven oh-my-openagent patterns into a Grok-native plugin (hooks + skills + rules, workspace state in .omg/).
It complements oh-my-openagent; it does not replace it. Use omo for OpenCode/Codex/multi-harness; use oh-my-grok when you work in Grok Build only.
| Feature | What it does | Toggle / entry |
|---|---|---|
| Bundled superpowers | TDD, debugging, planning, verification skills (obra/superpowers) | vendor/superpowers/skills/ |
| Skill gate | Blocks mutating tools until matching SKILL.md is Read |
(always on when catalog non-empty) |
| IntentGate | Injects search / analyze / team / hyperplan mode banners from prompt keywords | OMG_INTENT_GATE (default 1) |
| Hashline | LINE#ID tags on Read; PreToolUse blocks stale anchors in StrReplace |
OMG_HASHLINE · skill hashline-edit |
| Prometheus | /plan interview + md-only writes; /start-work → boulder |
OMG_PLAN_MODE · skill prometheus-plan |
| ast-grep | Bundled MCP for structural search / rewrite | .mcp.json · skill ast-grep |
| LSP | Post-edit error diagnostics; Stop blocks until fixed | OMG_LSP_ENFORCE · skill lsp |
| Todo enforcer | Cooldown + abort window so Stop todo continuation does not spin | (built into Stop chain) |
| Ralph / Ultrawork | Work-until-done loops via Stop | /ralph-loop, /ulw-loop |
| Todo + boulder | Plan progress + todo mirror under .omg/ |
Stop chain steps 2–3 |
| Handoff | /handoff session summary for the next chat |
/handoff |
| Merged hooks | One UserPromptSubmit payload (no overwrite) |
user-prompt.sh |
| Stop chain | Ralph → boulder → todos → LSP → plan.md |
hooks/README.md |
OMG_* env vars: docs/configuration.md.
Visual demos (TUI with plugin enabled, /ralph-loop in action) coming soon.
Requires Grok Build CLI 0.1.x or newer (tested with 0.2.x).
| Check | Where |
|---|---|
grok plugin validate . |
After install (local Grok CLI) |
| Hook smoke tests | GitHub Actions CI when billing active |
| Inline skill-gate E2E | Local: hooks/test-inline-skill-gate.sh |
Reload hooks after install: new session or TUI Ctrl+L → Hooks.
| Vanilla Grok Build | oh-my-grok | |
|---|---|---|
| Productivity plugin | Bring your own / none | Batteries-included oh-my patterns |
| Skill gate | Manual | Hook-enforced catalog Read |
| Long-running loops | No | /ralph-loop, /ulw-loop |
| Workspace state | Ad hoc | .omg/ (boulder, todos, handoff, ralph) |
| Stop continuation | Session ends | Unified Stop chain with pause/resume |
Upstream inspiration for loop/boulder/handoff patterns: oh-my-openagent (different harness).
- Install and enable (commands above).
- Open a project; optional: add
AGENTS.mdat repo root. - Run a slash command:
| Command | Effect | Example |
|---|---|---|
/ralph-loop "task" |
Work-until-done loop | /ralph-loop "fix failing hook tests" |
/ulw-loop "task" |
Ralph + verification | /ultrawork "ship docs polish" |
/cancel-ralph |
Clear loop state | /cancel-ralph |
/handoff |
Session handoff summary | /handoff |
/stop-continuation |
Pause auto-continue | /stop-continuation |
/resume-continuation |
Resume auto-continue | /resume-continuation |
Docs: Installation · Skills · Configuration · Troubleshooting · Examples · Roadmap
Hook internals: hooks/README.md
See docs/configuration.md — .omg/ workspace state, ~/.grok/installed-plugins/, no duplicate ~/.grok/hooks/.
Project skills: .agents/skills/ or .grok/skills/. Full catalog via grok inspect. Details: docs/skills.md.
docs/troubleshooting.md — stale install, double hooks, skill-gate blocks, loops that won’t stop.
Agents: use implementation docs, not this marketing page:
https://raw.githubusercontent.com/mihazs/oh-my-grok/main/AGENTS.md
https://raw.githubusercontent.com/mihazs/oh-my-grok/main/docs/installation.md
See CONTRIBUTING.md — conventional commits, hook tests, complements oh-my-openagent.
Open an issue for bugs or feature requests.
- Issues: GitHub Issues (bug / feature templates)
- Roadmap: ROADMAP.md
- Releases: CHANGELOG.md — v0.1.0 published; use
scripts/manual-release.shwhen Actions billing is locked
cd oh-my-grok
grok plugin validate .
export GROK_PLUGIN_ROOT="$(pwd)"
for t in hooks/test-*.sh; do
case "$(basename "$t")" in test-inline-skill-gate.sh) continue ;; esac
bash "$t"
done