grok

The grok worker exposes the xAI Grok CLI as iii functions. One grok::run call executes one headless Grok turn (grok --single <prompt> --output-format streaming-json) — the same agent the user runs in their terminal, with the same XAI_API_KEY, filesystem, and working directory — in a chosen directory, and returns the final result. Every Grok event mirrors untouched onto the grok::events stream; a translated AgentEvent view lands on agent::events, which is what the iii console renders.

Requires the grok CLI on the host with XAI_API_KEY in the worker environment. When a turn needs a capability beyond Grok itself, add another iii worker to the bus instead of bolting anything onto this one.

When to Use