| 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 ...
