harness-optimize (Grok plugin)

Grok-first harness doctor: diagnose live config, then emit reviewable proposed diffs (which file, what change, why now, how to revert). Scorecard is secondary. Full changelog since last run, new Grok release check, MCP doctor, permissions, dual rules — apply only after you approve.

A harness doctor becomes trustworthy when its own fixes are reviewable.

Install (easiest)

# From GitHub (recommended)
grok plugin install fubak/harness-optimize --trust
grok plugin enable harness-optimize

# Pin a release
grok plugin install fubak/harness-optimize@v0.1.0 --trust

# Or from a local clone
grok plugin install /path/to/harness-optimize --trust
grok plugin enable harness-optimize

Repo: https://github.com/fubak/harness-optimize
Release: https://github.com/fubak/harness-optimize/releases/tag/v0.1.0

Then in Grok:

/harness-optimize
# or
/harness-optimize grok

Or: “optimize my Grok harness setup” (skill auto-triggers from description).

Enable in config if needed:

[plugins]
enabled = ["harness-optimize"]  # plus your other plugins

What you get

Piece	Role
Skill harness-optimize	Full report → ask → apply loop
Command /harness-optimize	One-shot invoke
scripts/run-diagnostics.sh	Read-only diagnostics pack
recipes/	Apply id → concrete patch recipes
templates/	Deny-list starter, etc.

Does not ship your secrets, state.json, or machine reports.

Requirements

• Grok CLI with plugin support
• Optional: python3, jq/rg for richer diagnostics
• grok mcp doctor for MCP health scoring

Develop / validate

grok plugin validate .
grok plugin install . --trust
grok plugin details harness-optimize

License

MIT