Skip to content

Add a SuperGrok (Grok Build) setup skill for Zo #122

Description

@ss251

Summary

Add a community skill that installs and configures xAI's Grok Build CLI on a Zo Computer and authenticates it with an existing SuperGrok account through the supported device-code flow.

Motivation

Zo documents subscription-backed setup for Claude Code and Codex, but there is no equivalent discoverable workflow for SuperGrok. Users can use their subscription through the official Grok Build CLI without requiring API-key authentication.

Because a Zo Computer is a remote Linux environment, the integration should use grok login --device-auth, present the URL and one-time code to the user, and leave the OAuth credential lifecycle to the official client.

Scope

  • Add Community/supergrok-setup/SKILL.md and DISPLAY.json.
  • Detect an existing grok installation before installing or updating it.
  • Install only from xAI's documented installer at https://x.ai/cli/install.sh.
  • Use the official device-code login; never request, copy, or persist raw OAuth tokens.
  • Verify the result with non-secret commands such as grok version, grok models, and grok inspect --json.
  • Explain the privacy/configuration review required before opening sensitive repositories.
  • Detect model credential or endpoint overrides that can route verification away from the subscription session.
  • Clearly distinguish subscription-backed Grok Build access from API-key or custom-model paths that may use different billing and routing.
  • Clearly state that this adds a terminal integration, not a first-class model in Zo's chat provider picker.

Acceptance criteria

  • The skill follows the repository's Community skill structure and metadata requirements.
  • The setup is suitable for a headless/remote Zo Computer.
  • Authentication pauses for the user to complete the xAI device authorization page.
  • No API key or OAuth token is declared in DISPLAY.json or printed by the workflow.
  • The workflow is idempotent and does not overwrite unrelated Grok configuration.
  • bun validate passes.
  • The skill links to the current official xAI Grok Build documentation.

Out of scope

First-class SuperGrok support in Settings → AI Providers requires changes in Zo's private application code and is not implementable in this public registry repository.

References

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions