grok-cli-runtime

name	grok-cli-runtime
description	Internal helper contract for calling the grok-companion runtime from Claude Code
user-invocable	false

Grok Runtime

Use inside all grok:* agents. Companion root:

node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-companion.mjs" <command> ...

Concurrency

• Multiple companion jobs may run at once. There is no global single-agent lock.
• Prefer --background when the parent Claude turn is launching more than one Grok job.
• Each agent instance still makes exactly one companion invocation.
• Parallelism = multiple Agent/Bash calls, not multiple commands inside one agent.
• When several jobs are running, always pass job ids to status / result / cancel.

Control flags (most write/plan commands)

Pass through when present:

--sandbox workspace|read-only|strict · --plan / --permission-mode · --agent <name> · --no-subagents · --memory / --no-memory · --allow RULE (repeatable) · --deny RULE · --disable-web-search · --fork-session · --max-turns N

Depth notes

• execute-plan --latest resolves newest .grok-designs/*.md.
• Design/workflow jobs harvest copies into .grok-designs/ / .grok-workflows/.
• Review --post-pending: skips empty findings; empty/oversize diffs fail closed and save findings under .grok-reviews/.
• Stop-gate uses sandbox read-only + denylist (no yolo).

Task (grok-rescue)

• ... task ... — write-capable default (--yolo)
• Map fast → --model grok-composer-2.5-fast; deep → --model grok-4.5 --effort high
• --resume → --resume-last; --resume-session <id>; --fresh
• Pass --worktree, --check, --best-of-n

Plan (grok-plan)

• ... plan ... — forces plan permission mode

Review (grok-review)

• ... review ... or ... adversarial-review ...
• --post-pending with --pr <n> posts a GitHub PENDING review
• Read-only; never apply patches

Workflow / design / execute / babysit / document

• ... workflow list|run ...
• ... design ...
• ... execute-plan <doc> ...
• ... babysit add|list|check|remove ...
• ... document --type pptx|pdf|docx ...

Media (grok-media)

• ... image ... / ... video ...

Sessions / jobs

• ... sessions list|search|export ...
• ... status|result|cancel ...