Skip to content

Add official support for grok Build (xAI)#2028

Open
adamouabakar wants to merge 3 commits into
garrytan:mainfrom
adamouabakar:main
Open

Add official support for grok Build (xAI)#2028
adamouabakar wants to merge 3 commits into
garrytan:mainfrom
adamouabakar:main

Conversation

@adamouabakar

Copy link
Copy Markdown

Add official support for Grok Build (xAI)

What was added:

  • New host configuration file hosts/grok-build.ts
  • Updated hosts/index.ts to register the new host
  • Generated and adapted 55+ skills for Grok Build compatibility
  • Path rewrites, tool rewrites (browser → subagents), and Windows support

Tested successfully on:

  • Windows + Grok Build CLI
  • Core commands like /office-hours, /plan-ceo-review, /review, /cso are working

Why this contribution?
Grok Build is gaining popularity in the xAI ecosystem. This makes GStack natively plug-and-play for Grok users, similar to Claude Code, Cursor, and others.

It allows solopreneurs and developers using Grok to fully benefit from Garry Tan’s structured workflows (YC Office Hours, reviews, QA, etc.).

Ready to merge.

@trunk-io

trunk-io Bot commented Jun 16, 2026

Copy link
Copy Markdown

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

@jbetala7

Copy link
Copy Markdown
Contributor

Thanks for adding Grok Build support. The host layer here — hosts/grok-build.ts plus the ALL_HOST_CONFIGS registration in hosts/index.ts — is exactly the right shape and is only ~50 lines. The blocker is the other ~66k lines: this PR commits the generated .grok/skills/** output (55 SKILL.md files), and no other host does that.

  • git ls-files | grep -E '^\.(codex|cursor)/skills/' returns 0 on main — generated host skills are never checked in; they're produced from the HostConfig by the generator at install/generation time. .cursor/ is even listed in .gitignore.
  • The committed per-host convention is a single golden fixture: test/fixtures/golden/{claude,codex,factory,gbrain,hermes,openclaw}-ship-SKILL.md, wired into the host-config golden test. There's no grok-build-ship-SKILL.md here.

To make this reviewable and mergeable:

  1. Drop all .grok/skills/** files, and add .grok/skills/ to .gitignore so they don't get recommitted.
  2. Add test/fixtures/golden/grok-build-ship-SKILL.md and include grok-build in the host-config golden test the same way the other hosts are.
  3. Follow the version convention: prefix the title with the next vX.Y.Z.Z, bump VERSION, and add a CHANGELOG.md entry — the "Sync PR title to VERSION" check keys on this.

Heads-up on overlap: #2016 also touches "grok" but is orthogonal — it adds a /grok skill that calls Grok from inside Claude Code, whereas this PR adds Grok Build as a host that runs gstack. They don't collide, but coordinating naming would help future readers.

After trimming, the real diff is the two .ts files plus one fixture, which is easy to review. Happy to re-check once it's slimmed down.

@adamouabakar

Copy link
Copy Markdown
Author

Thanks for the detailed feedback, @jbeta7 !

I have cleaned up the pull request. :

-Removed all generated files in .grok/skills/**

  • Added .grok/skills/ to .gitignore
    -Added the golden fixture test/fixtures/golden/grok-build-ship-SKILL.md
  • Updated the commit with the clear message

The pull request is now very lightweight and follows the convention of the other hosts.

Ready for review/merge. Thanks !

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants