Connect Grok Build as a first-class coding agent

[shawnyeager]

Grok Build can now be connected the same way Codex is.

hey setup grok copies the HEY skill into $GROK_HOME/skills/hey (default ~/.grok/skills/hey). hey skill install, skill refresh, hey doctor, hey setup agents, and --remove all include Grok. There is no Grok plugin. Health is skill presence only, matching Codex.

HEY_SETUP_AGENT accepts grok. all attempts every registered agent, including Grok. Detection uses $GROK_HOME or ~/.grok, or a grok binary on PATH, matching Codex.

Session-settled decisions carried from planning: Grok matches Codex, not Claude — no .grok-plugin (user-directed); detect via $GROK_HOME/~/.grok or the grok binary (user-approved); HEY_SETUP_AGENT=all uses AllAgents() so Grok is always attempted (user-approved).

Tests

• make test passed locally (go test ./internal/...)

---

Summary by cubic

Adds Grok Build as a first-class coding agent, connected the same way Codex is.

• hey setup grok copies the HEY skill into $GROK_HOME/skills/hey (default ~/.grok/skills/hey).
• hey skill install, skill refresh, hey doctor, hey setup agents, and --remove all include Grok.
• Grok health is skill presence only; there is no Grok plugin yet.
• HEY_SETUP_AGENT accepts grok, and all now attempts every registered agent including Grok.
• Grok is detected via $GROK_HOME/~/.grok or a grok binary on PATH.

^{Written for commit b5b1102. Summary will update on new commits.}

[github-actions]

Sensitive Change Detection (shadow mode)

This PR modifies control-plane files:

• scripts/install.ps1
• scripts/install.sh

Shadow mode — this check is informational only. When activated, changes to these paths will require approval from a maintainer.

[Copilot]

Pull request overview

Adds Grok Build as a first-class coding-agent integration alongside Claude Code and Codex.

Changes:

• Adds Grok detection, skill installation, health checks, refresh, and removal.
• Integrates Grok into setup commands, environment selection, documentation, and installer behavior.
• Expands tests, though binary-only Grok detection remains untested.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
.surface	Adds the Grok setup command.
AGENTS.md	Documents Grok architecture.
README.md	Documents Grok setup and selection.
scripts/install.ps1	Documents the Grok selector.
scripts/install.sh	Documents the Grok selector.
tests/e2e/installer.bats	Extends installer compatibility coverage.
internal/harness/grok.go	Implements Grok detection and health checks.
internal/harness/grok_test.go	Tests Grok home and skill health.
internal/harness/agent.go	Updates agent metadata examples.
internal/harness/agent_test.go	Verifies Grok registration.
internal/cmd/setup_agent.go	Implements hey setup grok.
internal/cmd/setup_agents.go	Adds Grok selection and aggregation.
internal/cmd/setup_agents_test.go	Tests Grok setup and removal flows.
internal/cmd/setup_agents_remove.go	Removes managed Grok skills.
internal/cmd/setup_test.go	Covers Grok command registration.
internal/cmd/skill_install.go	Installs skills for detected Grok.
internal/cmd/skill_install_test.go	Tests Grok ownership protections.
internal/cmd/skill_refresh.go	Refreshes Grok skill copies.
internal/cmd/skill_refresh_test.go	Tests Grok refresh behavior.
internal/cmd/help_topics.go	Documents Grok environment selection.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.