Skip to content

Releases: mihazs/oh-my-grok

v0.2.1

03 Jun 22:02

Choose a tag to compare

oh-my-grok v0.2.1

Install

grok plugin install github:mihazs/oh-my-grok@v0.2.1 --trust
grok plugin enable oh-my-grok

Fixes

  • Hooks from the plugin not being called after install or updates (stale user/<hash>/name entries in ~/.grok/config.toml [plugins] enabled could cause reload_plugins_impl to report 0 hooks or skip registration of the current snapshot's hooks/hooks.json).
  • Expanded "Hooks do not run after install" troubleshooting with detailed reload steps (Plugins r, Hooks l), reinstall from path, verification commands (plugin list/details, TUI Hooks tab under Plugin source, recent non-test state dirs under ~/.grok/state/skill-gate/ and using-superpowers/ after a prompt), and scrollback annotation notes.
  • scripts/remove-global-overlays.sh now also sanitizes stale plugin IDs from the enabled list (removes old user/xxx/oh-my-grok and superpowers entries, ensures canonical short names like oh-my-grok are present; backs up config). This complements the global hooks/skills/rules cleanup and grok plugin enable.

v0.2.0

03 Jun 04:04

Choose a tag to compare

oh-my-grok v0.2.0

Install

grok plugin install github:mihazs/oh-my-grok@v0.2.0 --trust
grok plugin enable oh-my-grok

Features

  • Bundled superpowersvendor/superpowers/skills/ (obra/superpowers v5.1.0); no separate superpowers plugin install
  • Go hook runtimebin/omg-hook-* replaces bash/python hook libs; hooks/run-hook.sh dispatcher
  • IntentGate, Prometheus plan mode, hashline read cache + PreToolUse guard, LSP diagnostics stash
  • Bundled ast-grep and lsp-tools MCP servers (scripts/build-mcp-runtimes.sh)
  • Todo enforcer cooldown/abort window on Stop chain
  • Taskfile.yml for dev/CI commands

Fixes

  • Ralph / Ultrawork Stop continuation on Grok Composer 2.5 (workspace env + stopReason handling)
  • Proactive skill loading: <AGENT_SKILL_GATE_PROACTIVE>, Grok Read-tool guidance vs skill_information metadata
  • Hashline cache on any Read (not only SKILL.md)

Chores

  • lefthook pre-commit rebuilds bin/omg-hook-*
  • SessionStart runs on all session starts (removed narrow matcher)

v0.1.0

02 Jun 23:44

Choose a tag to compare

oh-my-grok v0.1.0

First public release of the Grok Build productivity plugin (manual release while GitHub Actions billing is locked).

Install

grok plugin install github:mihazs/oh-my-grok@v0.1.0 --trust
grok plugin enable oh-my-grok

Requires Grok Build CLI 0.1.x+ (tested on 0.2.x). Run grok plugin validate . after install.

Features

  • Skill gate — hooks block mutating tools until catalog skills are Read
  • Ralph loop/ralph-loop work-until-done with Stop continuations
  • Ultrawork/ulw-loop, /ultrawork with verifier gate before exit
  • Todo + boulder.omg/boulder.json, plans, todo mirror
  • Handoff/handoff for new-session continuity
  • Merged hooks — single UserPromptSubmit context
  • Workspace contextAGENTS.md + plugin rules/*.md each prompt
  • Stop chain — Ralph → boulder → todos → plan (see hooks/README.md)

Slash commands

Command Purpose
/ralph-loop "task" Work-until-done
/ulw-loop "task" Ralph + verification
/cancel-ralph Clear loop
/handoff Session handoff
/stop-continuation Pause auto-continue
/resume-continuation Resume

Documentation

Complements oh-my-openagent — Grok Build only, not a replacement.

CI note

Hook smoke tests are defined in .github/workflows/ci.yml. They run when GitHub Actions billing is restored. Local test:

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