Grok CLI Engine

​

Requirements

• Node.js 22.12 or later
• Grok CLI 1.0.5
• Host-selected authentication

​

Install

pnpm add @obversa/engine-grok-cli

​

Identity

​

Usage

import { GrokCliEngine } from '@obversa/engine-grok-cli';

const engine = new GrokCliEngine({
  executable: '/absolute/path/to/grok',
  version: '1.0.5',
  identity: { provider: 'xai', modelFamily: 'grok-4' },
  permissionMode: 'dontAsk',
});

​

Limits

• The plugin requires an absolute path to the Grok executable.
• The constructor stores the version string provided in options; it does not probe the binary.
• Each attempt runs in an isolated directory with declared tool permissions.