Skip to content

Grok Build support: one source, two tools - #11

Merged
HermeticOrmus merged 7 commits into
feature/5-open-the-kitchenfrom
feature/10-grok-build
Oct 1, 2026
Merged

HermeticOrmus merged 7 commits into
feature/5-open-the-kitchenfrom
feature/10-grok-build

Conversation

@HermeticOrmus

Copy link
Copy Markdown
Collaborator

Stacked on #9; merge that first.

Grok Build reads these plugin folders as they are (it loads .claude-plugin/plugin.json), but it only finds a marketplace at .grok-plugin/marketplace.json. This PR adds that file, generated from the Claude manifest, plus CI, docs, a --grok installer flag and the kintsugi ledger. One source serves both tools; nothing is removed.

What changed

  • scripts/sync-grok-manifest.py writes .grok-plugin/marketplace.json from .claude-plugin/marketplace.json (71 plugins); --check exits 1 when the committed file is stale. Same script as the rest of the wave, unchanged.
  • .github/workflows/validate.yml gains the shared grok job, unchanged: manifest drift check, install the Grok Build CLI, grok plugin validate on every plugin, install all 71 into a clean GROK_HOME from the checkout. The existing plugins job is unchanged.
  • setup.sh --grok installs through the grok CLI instead of claude, with the same --only, --list and --uninstall behavior. A local marketplace registers under its directory name, so the script finds it by path; a full --uninstall removes that marketplace, which removes exactly its plugins. --grok passes --trust, and the usage header says so. --scope is Claude Code only and prints a note.
  • A crack found on the way (K-17 in the ledger, sealed here): Grok names plugins without their marketplace, 66 names here are also in claude-code-game-development and design-mastery is also in design-mastery-claude-code, and grok plugin uninstall <name> removes one copy by name. In a clean GROK_HOME, with code-documentation installed from this checkout and then from a game-dev checkout, it removed this pack's copy. So --uninstall --only skips a name that is also installed from somewhere else (transcript below), and the README says to remove a pack with ./setup.sh --grok --uninstall.
  • README: ### Install in Grok Build right after the Claude Code install (marketplace commands, a direct grok plugin install HermeticOrmus/LibreUIUX-Claude-Code#plugins/design-mastery, ./setup.sh --grok, the shared-name note, and a line that libreuiux-hooks uses a format Grok supports but is not verified in a live Grok session). QUICK_START has no Claude Code plugin install block (it starts from a CLAUDE.md template), so its short Grok block sits at the end of Step 1 and points to the README for Claude Code. Everything else stays.
  • LEDGER.md: 16 cracks the 2.0.0 release found and sealed (hallmarked with the release PR and its CHANGELOG line or commits), 1 sealed here, and 5 open: Write the two intermediate examples the README links to #6, Write the two advanced guides the README links to #7, Package the root .claude UI commands and synthesis-master agent as a plugin #8, the 48 broken relative links (Menu atom link-check-ci), and the hooks runtime in Grok. Linked from the README Feedback section.
  • CHANGELOG [Unreleased]: Grok Build support, --grok, the ledger.

The direct subfolder install already works against main. grok plugin marketplace add HermeticOrmus/LibreUIUX-Claude-Code needs this merged, since main has no .grok-plugin/ yet. For the ledger, the released 2.0.0 was installed from GitHub into a clean Claude Code config again: 71 of 71 enabled.

Verification

grok 1.0.44, Claude Code 2.1.286. Every Grok install ran in a fresh GROK_HOME=$(mktemp -d). Grok also lists the machine's Claude Code marketplaces read-only; that is expected and nothing was written to them. Paths are shortened to <worktree> and $GROK_HOME.

Manifest check and grok plugin validate
## sync-grok-manifest --check
$ python3 scripts/sync-grok-manifest.py --check
grok manifest in sync: 71 plugins
exit=0

## grok plugin validate (every plugin)
grok 1.0.44 (5b807183dd79) [stable]
./plugins/code-documentation: Plugin manifest is valid. (exit=0)
./plugins/debugging-toolkit: Plugin manifest is valid. (exit=0)
./plugins/git-pr-workflows: Plugin manifest is valid. (exit=0)
./plugins/backend-development: Plugin manifest is valid. (exit=0)
./plugins/frontend-mobile-development: Plugin manifest is valid. (exit=0)
./plugins/full-stack-orchestration: Plugin manifest is valid. (exit=0)
./plugins/unit-testing: Plugin manifest is valid. (exit=0)
./plugins/tdd-workflows: Plugin manifest is valid. (exit=0)
./plugins/code-review-ai: Plugin manifest is valid. (exit=0)
./plugins/code-refactoring: Plugin manifest is valid. (exit=0)
./plugins/dependency-management: Plugin manifest is valid. (exit=0)
./plugins/error-debugging: Plugin manifest is valid. (exit=0)
./plugins/team-collaboration: Plugin manifest is valid. (exit=0)
./plugins/llm-application-dev: Plugin manifest is valid. (exit=0)
./plugins/agent-orchestration: Plugin manifest is valid. (exit=0)
./plugins/context-management: Plugin manifest is valid. (exit=0)
./plugins/machine-learning-ops: Plugin manifest is valid. (exit=0)
./plugins/data-engineering: Plugin manifest is valid. (exit=0)
./plugins/incident-response: Plugin manifest is valid. (exit=0)
./plugins/error-diagnostics: Plugin manifest is valid. (exit=0)
./plugins/distributed-debugging: Plugin manifest is valid. (exit=0)
./plugins/observability-monitoring: Plugin manifest is valid. (exit=0)
./plugins/deployment-strategies: Plugin manifest is valid. (exit=0)
./plugins/deployment-validation: Plugin manifest is valid. (exit=0)
./plugins/kubernetes-operations: Plugin manifest is valid. (exit=0)
./plugins/cloud-infrastructure: Plugin manifest is valid. (exit=0)
./plugins/cicd-automation: Plugin manifest is valid. (exit=0)
./plugins/application-performance: Plugin manifest is valid. (exit=0)
./plugins/database-cloud-optimization: Plugin manifest is valid. (exit=0)
./plugins/comprehensive-review: Plugin manifest is valid. (exit=0)
./plugins/performance-testing-review: Plugin manifest is valid. (exit=0)
./plugins/framework-migration: Plugin manifest is valid. (exit=0)
./plugins/codebase-cleanup: Plugin manifest is valid. (exit=0)
./plugins/database-design: Plugin manifest is valid. (exit=0)
./plugins/database-migrations: Plugin manifest is valid. (exit=0)
./plugins/security-scanning: Plugin manifest is valid. (exit=0)
./plugins/security-compliance: Plugin manifest is valid. (exit=0)
./plugins/backend-api-security: Plugin manifest is valid. (exit=0)
./plugins/frontend-mobile-security: Plugin manifest is valid. (exit=0)
./plugins/data-validation-suite: Plugin manifest is valid. (exit=0)
./plugins/api-scaffolding: Plugin manifest is valid. (exit=0)
./plugins/api-testing-observability: Plugin manifest is valid. (exit=0)
./plugins/seo-content-creation: Plugin manifest is valid. (exit=0)
./plugins/seo-technical-optimization: Plugin manifest is valid. (exit=0)
./plugins/seo-analysis-monitoring: Plugin manifest is valid. (exit=0)
./plugins/documentation-generation: Plugin manifest is valid. (exit=0)
./plugins/multi-platform-apps: Plugin manifest is valid. (exit=0)
./plugins/business-analytics: Plugin manifest is valid. (exit=0)
./plugins/hr-legal-compliance: Plugin manifest is valid. (exit=0)
./plugins/customer-sales-automation: Plugin manifest is valid. (exit=0)
./plugins/content-marketing: Plugin manifest is valid. (exit=0)
./plugins/blockchain-web3: Plugin manifest is valid. (exit=0)
./plugins/quantitative-trading: Plugin manifest is valid. (exit=0)
./plugins/payment-processing: Plugin manifest is valid. (exit=0)
./plugins/game-development: Plugin manifest is valid. (exit=0)
./plugins/accessibility-compliance: Plugin manifest is valid. (exit=0)
./plugins/python-development: Plugin manifest is valid. (exit=0)
./plugins/javascript-typescript: Plugin manifest is valid. (exit=0)
./plugins/systems-programming: Plugin manifest is valid. (exit=0)
./plugins/jvm-languages: Plugin manifest is valid. (exit=0)
./plugins/web-scripting: Plugin manifest is valid. (exit=0)
./plugins/functional-programming: Plugin manifest is valid. (exit=0)
./plugins/julia-development: Plugin manifest is valid. (exit=0)
./plugins/arm-cortex-microcontrollers: Plugin manifest is valid. (exit=0)
./plugins/shell-scripting: Plugin manifest is valid. (exit=0)
./plugins/developer-essentials: Plugin manifest is valid. (exit=0)
./plugins/design-mastery: Plugin manifest is valid. (exit=0)
./plugins/archetypal-alchemy: Plugin manifest is valid. (exit=0)
./plugins/mcp-integrations: Plugin manifest is valid. (exit=0)
./plugins/vibe-coding: Plugin manifest is valid. (exit=0)
./plugins/libreuiux-hooks: Plugin manifest is valid. (exit=0)
validated 71 plugins, failures: 0

Clean GROK_HOME install from the worktree, list, details
## clean GROK_HOME install from the worktree (HEAD e4f31d4)
$ export GROK_HOME=$(mktemp -d)
$ grok plugin marketplace add <worktree>
Added marketplace source: LibreUIUX-Claude-Code-10 (<worktree>)
exit=0
$ for p in <every plugin in .grok-plugin/marketplace.json>; do grok plugin install "$p@LibreUIUX-Claude-Code-10" --trust; done
installed 71 of 71
$ grok plugin list
  accessibility-compliance-a2f0fb23: accessibility-compliance [local: <worktree>/plugins/accessibility-compliance] (LibreUIUX-Claude-Code-10)
  agent-orchestration-6ee7230d: agent-orchestration [local: <worktree>/plugins/agent-orchestration] (LibreUIUX-Claude-Code-10)
  api-scaffolding-326d8e38: api-scaffolding [local: <worktree>/plugins/api-scaffolding] (LibreUIUX-Claude-Code-10)
  api-testing-observability-a9100ce0: api-testing-observability [local: <worktree>/plugins/api-testing-observability] (LibreUIUX-Claude-Code-10)
  application-performance-d98d8776: application-performance [local: <worktree>/plugins/application-performance] (LibreUIUX-Claude-Code-10)
  archetypal-alchemy-aaa30cdc: archetypal-alchemy [local: <worktree>/plugins/archetypal-alchemy] (LibreUIUX-Claude-Code-10)
  arm-cortex-microcontrollers-7ea28fb6: arm-cortex-microcontrollers [local: <worktree>/plugins/arm-cortex-microcontrollers] (LibreUIUX-Claude-Code-10)
  backend-api-security-fb1bc905: backend-api-security [local: <worktree>/plugins/backend-api-security] (LibreUIUX-Claude-Code-10)
  backend-development-f79be274: backend-development [local: <worktree>/plugins/backend-development] (LibreUIUX-Claude-Code-10)
  blockchain-web3-cea1a0fb: blockchain-web3 [local: <worktree>/plugins/blockchain-web3] (LibreUIUX-Claude-Code-10)
  business-analytics-6d180438: business-analytics [local: <worktree>/plugins/business-analytics] (LibreUIUX-Claude-Code-10)
  cicd-automation-39fe8288: cicd-automation [local: <worktree>/plugins/cicd-automation] (LibreUIUX-Claude-Code-10)
  cloud-infrastructure-4e64c251: cloud-infrastructure [local: <worktree>/plugins/cloud-infrastructure] (LibreUIUX-Claude-Code-10)
  code-documentation-fcf17605: code-documentation [local: <worktree>/plugins/code-documentation] (LibreUIUX-Claude-Code-10)
  code-refactoring-10b31772: code-refactoring [local: <worktree>/plugins/code-refactoring] (LibreUIUX-Claude-Code-10)
  code-review-ai-b32eb9a6: code-review-ai [local: <worktree>/plugins/code-review-ai] (LibreUIUX-Claude-Code-10)
  codebase-cleanup-2472e5d4: codebase-cleanup [local: <worktree>/plugins/codebase-cleanup] (LibreUIUX-Claude-Code-10)
  comprehensive-review-c299b0f9: comprehensive-review [local: <worktree>/plugins/comprehensive-review] (LibreUIUX-Claude-Code-10)
  content-marketing-39012fa1: content-marketing [local: <worktree>/plugins/content-marketing] (LibreUIUX-Claude-Code-10)
  context-management-30051062: context-management [local: <worktree>/plugins/context-management] (LibreUIUX-Claude-Code-10)
  customer-sales-automation-50e431e2: customer-sales-automation [local: <worktree>/plugins/customer-sales-automation] (LibreUIUX-Claude-Code-10)
  data-engineering-c573cecb: data-engineering [local: <worktree>/plugins/data-engineering] (LibreUIUX-Claude-Code-10)
  data-validation-suite-99f99d9f: data-validation-suite [local: <worktree>/plugins/data-validation-suite] (LibreUIUX-Claude-Code-10)
  database-cloud-optimization-9c5ffa0b: database-cloud-optimization [local: <worktree>/plugins/database-cloud-optimization] (LibreUIUX-Claude-Code-10)
  database-design-f170975e: database-design [local: <worktree>/plugins/database-design] (LibreUIUX-Claude-Code-10)
  database-migrations-50587a7e: database-migrations [local: <worktree>/plugins/database-migrations] (LibreUIUX-Claude-Code-10)
  debugging-toolkit-9ec46061: debugging-toolkit [local: <worktree>/plugins/debugging-toolkit] (LibreUIUX-Claude-Code-10)
  dependency-management-84c12d5d: dependency-management [local: <worktree>/plugins/dependency-management] (LibreUIUX-Claude-Code-10)
  deployment-strategies-0259648a: deployment-strategies [local: <worktree>/plugins/deployment-strategies] (LibreUIUX-Claude-Code-10)
  deployment-validation-e8c26aac: deployment-validation [local: <worktree>/plugins/deployment-validation] (LibreUIUX-Claude-Code-10)
  design-mastery-326a459e: design-mastery [local: <worktree>/plugins/design-mastery] (LibreUIUX-Claude-Code-10)
  developer-essentials-8d9fda91: developer-essentials [local: <worktree>/plugins/developer-essentials] (LibreUIUX-Claude-Code-10)
  distributed-debugging-31feee74: distributed-debugging [local: <worktree>/plugins/distributed-debugging] (LibreUIUX-Claude-Code-10)
  documentation-generation-ec59c545: documentation-generation [local: <worktree>/plugins/documentation-generation] (LibreUIUX-Claude-Code-10)
  error-debugging-62749172: error-debugging [local: <worktree>/plugins/error-debugging] (LibreUIUX-Claude-Code-10)
  error-diagnostics-4efa58a9: error-diagnostics [local: <worktree>/plugins/error-diagnostics] (LibreUIUX-Claude-Code-10)
  framework-migration-86fb1620: framework-migration [local: <worktree>/plugins/framework-migration] (LibreUIUX-Claude-Code-10)
  frontend-mobile-development-9f0572fa: frontend-mobile-development [local: <worktree>/plugins/frontend-mobile-development] (LibreUIUX-Claude-Code-10)
  frontend-mobile-security-7ad90e53: frontend-mobile-security [local: <worktree>/plugins/frontend-mobile-security] (LibreUIUX-Claude-Code-10)
  full-stack-orchestration-03c2f5c8: full-stack-orchestration [local: <worktree>/plugins/full-stack-orchestration] (LibreUIUX-Claude-Code-10)
  functional-programming-c954f386: functional-programming [local: <worktree>/plugins/functional-programming] (LibreUIUX-Claude-Code-10)
  game-development-e2b8e9d1: game-development [local: <worktree>/plugins/game-development] (LibreUIUX-Claude-Code-10)
  git-pr-workflows-2bce5767: git-pr-workflows [local: <worktree>/plugins/git-pr-workflows] (LibreUIUX-Claude-Code-10)
  hr-legal-compliance-439c6133: hr-legal-compliance [local: <worktree>/plugins/hr-legal-compliance] (LibreUIUX-Claude-Code-10)
  incident-response-6ea06d46: incident-response [local: <worktree>/plugins/incident-response] (LibreUIUX-Claude-Code-10)
  javascript-typescript-2d354eae: javascript-typescript [local: <worktree>/plugins/javascript-typescript] (LibreUIUX-Claude-Code-10)
  julia-development-52deb570: julia-development [local: <worktree>/plugins/julia-development] (LibreUIUX-Claude-Code-10)
  jvm-languages-9b26dc6a: jvm-languages [local: <worktree>/plugins/jvm-languages] (LibreUIUX-Claude-Code-10)
  kubernetes-operations-2370e625: kubernetes-operations [local: <worktree>/plugins/kubernetes-operations] (LibreUIUX-Claude-Code-10)
  libreuiux-hooks-3bda8a67: libreuiux-hooks [local: <worktree>/plugins/libreuiux-hooks] (LibreUIUX-Claude-Code-10)
  llm-application-dev-849f2d36: llm-application-dev [local: <worktree>/plugins/llm-application-dev] (LibreUIUX-Claude-Code-10)
  machine-learning-ops-9b18f8ca: machine-learning-ops [local: <worktree>/plugins/machine-learning-ops] (LibreUIUX-Claude-Code-10)
  mcp-integrations-d178ec05: mcp-integrations [local: <worktree>/plugins/mcp-integrations] (LibreUIUX-Claude-Code-10)
  multi-platform-apps-294e6cc1: multi-platform-apps [local: <worktree>/plugins/multi-platform-apps] (LibreUIUX-Claude-Code-10)
  observability-monitoring-a913357a: observability-monitoring [local: <worktree>/plugins/observability-monitoring] (LibreUIUX-Claude-Code-10)
  payment-processing-2765b0fc: payment-processing [local: <worktree>/plugins/payment-processing] (LibreUIUX-Claude-Code-10)
  performance-testing-review-f38fd368: performance-testing-review [local: <worktree>/plugins/performance-testing-review] (LibreUIUX-Claude-Code-10)
  python-development-a8f2ff6f: python-development [local: <worktree>/plugins/python-development] (LibreUIUX-Claude-Code-10)
  quantitative-trading-fa178ce5: quantitative-trading [local: <worktree>/plugins/quantitative-trading] (LibreUIUX-Claude-Code-10)
  security-compliance-27a3c74e: security-compliance [local: <worktree>/plugins/security-compliance] (LibreUIUX-Claude-Code-10)
  security-scanning-3120e52f: security-scanning [local: <worktree>/plugins/security-scanning] (LibreUIUX-Claude-Code-10)
  seo-analysis-monitoring-79f57efc: seo-analysis-monitoring [local: <worktree>/plugins/seo-analysis-monitoring] (LibreUIUX-Claude-Code-10)
  seo-content-creation-e5cd7c14: seo-content-creation [local: <worktree>/plugins/seo-content-creation] (LibreUIUX-Claude-Code-10)
  seo-technical-optimization-22603471: seo-technical-optimization [local: <worktree>/plugins/seo-technical-optimization] (LibreUIUX-Claude-Code-10)
  shell-scripting-04c837fa: shell-scripting [local: <worktree>/plugins/shell-scripting] (LibreUIUX-Claude-Code-10)
  systems-programming-a2d82b5a: systems-programming [local: <worktree>/plugins/systems-programming] (LibreUIUX-Claude-Code-10)
  tdd-workflows-98e02996: tdd-workflows [local: <worktree>/plugins/tdd-workflows] (LibreUIUX-Claude-Code-10)
  team-collaboration-deccfb80: team-collaboration [local: <worktree>/plugins/team-collaboration] (LibreUIUX-Claude-Code-10)
  unit-testing-5e6fdf84: unit-testing [local: <worktree>/plugins/unit-testing] (LibreUIUX-Claude-Code-10)
  vibe-coding-2d4af268: vibe-coding [local: <worktree>/plugins/vibe-coding] (LibreUIUX-Claude-Code-10)
  web-scripting-47d590ea: web-scripting [local: <worktree>/plugins/web-scripting] (LibreUIUX-Claude-Code-10)
$ grok plugin list --json | jq length
71
$ grok plugin details design-mastery
design-mastery-326a459e
  path: $GROK_HOME/installed-plugins/design-mastery-326a459e
  kind: local: <worktree>/plugins/design-mastery
  source: LibreUIUX-Claude-Code-10
  installed: 2026-09-30T20:53:31.336279380+00:00
  updated: 2026-09-30T20:53:31.336279380+00:00
  plugins (1):
    design-mastery v1.1.0
  description: Design principles, legendary designers, and historical movements applied to UI work, with agents and workflows for brand identity, design audits, style guides, and premium landing pages.
  components: 1 skill dir(s), 1 command dir(s), 1 agent dir(s)
$ grok plugin details libreuiux-hooks
libreuiux-hooks-3bda8a67
  path: $GROK_HOME/installed-plugins/libreuiux-hooks-3bda8a67
  kind: local: <worktree>/plugins/libreuiux-hooks
  source: LibreUIUX-Claude-Code-10
  installed: 2026-09-30T20:53:31.994364288+00:00
  updated: 2026-09-30T20:53:31.994364288+00:00
  plugins (1):
    libreuiux-hooks v1.0.0
  description: Optional hooks for UI projects: one line of stack context at session start, a confirmation prompt before editing secrets files, and accessibility and design-system hints after UI file edits.
  components: 0 skill dir(s), 0 command dir(s), 0 agent dir(s), hooks

claude plugin validate, setup.sh --grok (--list, --only, --uninstall)
## claude plugin validate
$ claude plugin validate .
Validating marketplace manifest: <worktree>/.claude-plugin/marketplace.json

✔ Validation passed
exit=0

## setup.sh --grok in a fresh GROK_HOME
$ export GROK_HOME=$(mktemp -d)
$ ./setup.sh --grok --list
exit=0
code-documentation           Documentation generation, code explanation, and technical writing with automated doc generation and tutorial creation
debugging-toolkit            Interactive debugging, developer experience optimization, and smart debugging workflows
git-pr-workflows             Git workflow automation, pull request enhancement, and team onboarding processes
backend-development          Backend API design, GraphQL architecture, workflow orchestration with Temporal, and test-driven backend development
frontend-mobile-development  Frontend UI development and mobile application implementation across platforms
... 71 plugins listed
$ ./setup.sh --grok --only design-mastery,libreuiux-hooks
Added marketplace source: LibreUIUX-Claude-Code-10 (<worktree>)

Installed 2 plugin(s) from LibreUIUX-Claude-Code-10 into Grok Build. Restart Grok Build to load them.
Tell us what worked and what is missing: https://github.com/HermeticOrmus/LibreUIUX-Claude-Code/issues/new?template=feedback.yml
exit=0
$ grok plugin list
  design-mastery-326a459e: design-mastery [local: <worktree>/plugins/design-mastery] (LibreUIUX-Claude-Code-10)
  libreuiux-hooks-3bda8a67: libreuiux-hooks [local: <worktree>/plugins/libreuiux-hooks] (LibreUIUX-Claude-Code-10)
$ ./setup.sh --grok --uninstall
Removed marketplace source and uninstalled 2 plugin(s): design-mastery-326a459e, libreuiux-hooks-3bda8a67
Done. Restart Grok Build to unload what was removed.
exit=0
$ grok plugin list
No plugins installed. Run `grok plugin install --help` to get started.

Same-name skip: --uninstall --only leaves a code-documentation installed from elsewhere alone
$ export GROK_HOME=$(mktemp -d)
$ ./setup.sh --grok --only code-documentation,design-mastery
Added marketplace source: LibreUIUX-Claude-Code-10 (<worktree>)
Installed 1 plugin(s) from LibreUIUX-Claude-Code-10: code-documentation
Installed 1 plugin(s) from LibreUIUX-Claude-Code-10: design-mastery
Installed 2 plugin(s) from LibreUIUX-Claude-Code-10 into Grok Build. Restart Grok Build to load them.
$ grok plugin install HermeticOrmus/LibreUIUX-Claude-Code#plugins/code-documentation --trust
Installed 1 plugin(s) from HermeticOrmus/LibreUIUX-Claude-Code#plugins/code-documentation: code-documentation
$ grok plugin list
  code-documentation-7b92db3a: code-documentation [git: https://github.com/HermeticOrmus/LibreUIUX-Claude-Code]
  code-documentation-fcf17605: code-documentation [local: <worktree>/plugins/code-documentation] (LibreUIUX-Claude-Code-10)
  design-mastery-326a459e: design-mastery [local: <worktree>/plugins/design-mastery] (LibreUIUX-Claude-Code-10)
$ ./setup.sh --grok --uninstall --only code-documentation,design-mastery
skipped code-documentation: another plugin named code-documentation is installed, and grok uninstalls by name only.
Uninstalled 1 plugin(s): design-mastery
Done. Restart Grok Build to unload what was removed.
exit=0
$ grok plugin list
  code-documentation-7b92db3a: code-documentation [git: https://github.com/HermeticOrmus/LibreUIUX-Claude-Code]
  code-documentation-fcf17605: code-documentation [local: <worktree>/plugins/code-documentation] (LibreUIUX-Claude-Code-10)
Diff scan: em dashes and personal data
## diff scan against origin/feature/5-open-the-kitchen
$ git diff origin/feature/5-open-the-kitchen -- . | grep '^+' | grep -c U+2014 (em dashes added)
0
$ git diff origin/feature/5-open-the-kitchen | grep -nE personal-data patterns
no matches

Closes #10

🤖 Generated with Claude Code

Grok Build loads these plugin folders as they are, since it reads
.claude-plugin/plugin.json, but it only finds a marketplace at
.grok-plugin/marketplace.json. The script derives that file from the
Claude manifest, so there is one source and no hand-kept copy to drift;
--check exits 1 when the committed file is stale.

Refs: #10
People on Grok Build could read the plugins but had no one-step install
from a checkout. --grok keeps --only, --list and --uninstall and swaps
the claude calls for grok ones. A local marketplace registers under its
directory name, so the script finds it by path; a full --uninstall
removes that marketplace, which removes exactly its plugins.

Grok uninstalls plugins by name only, and another pack can ship a
plugin with the same name, so --uninstall --only skips a name that is
also installed from somewhere else rather than remove the wrong copy.

Refs: #10
Claude Code CI alone cannot tell us when a plugin stops loading in Grok
Build. The new job fails when the generated Grok manifest drifts from
the Claude one, runs grok plugin validate on every plugin, and installs
them all into a clean GROK_HOME from the checkout.

Refs: #10
The README and QUICK_START only told Claude Code users how to install.
The README now has an Install in Grok Build block after the Claude one,
with the marketplace commands, a direct install of one plugin folder,
and ./setup.sh --grok. QUICK_START had no plugin install block, so its
short Grok block sits at the end of Step 1 and points to the README for
Claude Code. Both warn that libreuiux-hooks is not yet verified in a
live Grok session, and the README warns that grok uninstalls by name
while 67 names are shared with sibling packs.

Refs: #10
The 2.0.0 release fixed a marketplace name that collided with
wshobson/agents, three plugins nobody could install, hooks that never
ran and missing upstream credit, but the record was spread across the
CHANGELOG and commits. LEDGER.md gives each crack one row with its
evidence, grade and seal, adds the Grok same-name uninstall crack this
branch seals, and lists the cracks still open (#6, #7, #8, the broken
link count, the hooks runtime in Grok). The README links it from
Feedback.

Refs: #10
Records the Grok marketplace and CI job, ./setup.sh --grok, and the
kintsugi ledger, so the next release notes start from them.

Refs: #10
Grok 1.0.44 registers a marketplace added from GitHub under the repo name, not the manifest name: ServiceNow/sdk (manifest servicenow) installs as plugin@sdk or plugin@ServiceNow/sdk, while plugin@servicenow fails with Unknown marketplace. Claude Code lines keep the manifest name, which is right there.

Refs: #10
@HermeticOrmus
HermeticOrmus merged commit 1ac83c0 into feature/5-open-the-kitchen Oct 1, 2026
2 checks passed
@HermeticOrmus
HermeticOrmus deleted the feature/10-grok-build branch October 1, 2026 02:21
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.

1 participant