Grok

Agent·runs grok·by Hivemind

xAI's Grok coding CLI.

hive agents install grok

Source and documentation →

What it can do on the canvas

—Resumes a session
—Reports when a turn ends
—Can be supervised by another agent

launches and reads status; other agents cannot collect its replies.

Options

Set per tile, before the agent starts.

Model--model
Permission mode--permission-mode

Installing the CLI itself

Hivemind runs a command that is already on your machine — it never installs one for you. This is the publisher's own instruction.

curl -fsSL https://x.ai/cli/install.sh | bash

The manifest

The whole file, as the app reads it. Everything above is derived from it.

Read agent.yaml

# Grok — built-in provider manifest.
# Authoring format for the def half. See packages/hive-agents/src/manifest.ts.
manifestVersion: 1
id: grok
label: Grok
bin: grok
aliases:
  - grok-build
enabled: true
caps:
  promptDelivery: typed
  turnSignal: false
  resume: none
  supervise: human
  blockedDetection: true
icon:
  viewBox: 0 0 24 24
  attrs:
    fill: currentColor
    fill-rule: evenodd
  shapes:
    - path:
        d: M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41
          7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661
          8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539
          2.388-8.42l.006.007c-.983-4.232.242-5.924
          2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267
          15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763
          4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975
          8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022
          2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815
options:
  - id: model
    label: Model
    flag: --model
  - id: mode
    label: Permission mode
    flag: --permission-mode
    unattended: bypassPermissions
install:
  url: https://docs.x.ai/build/overview
  command: "curl -fsSL https://x.ai/cli/install.sh | bash"
detect:
  rules:
    - when:
        any:
          - contains: use ← → to choose permission whitelist scope
          - contains: yes, proceed
          - contains: no, reject
          - contains: ctrl+o:yolo
          - contains: :scope
      then: blocked
    - when:
        all:
          - helper: hasBrailleSpinner
          - any:
              - contains: waiting
              - contains: "run "
              - contains: "read "
              - contains: "search "
              - contains: "list "
      then: working
    - when:
        all:
          - contains: ctrl+c:cancel
          - contains: ctrl+enter:interject
      then: working
  default: idle
note: launches and reads status; other agents cannot collect its replies.