Download the PHP package jordandalton/tackle-grok without Composer

Tackle Grok

A Grok (xAI) provider for Laravel Tackle — run your in-app AI coding agent on Grok models.

📚 Full documentation: tackle.jordandalton.com

That's the whole switch. Every Tackle agent — ai:code, ai:run, ai:fix, ai:review, the self-healer — now runs on xAI's Grok models.

This is a laravel/ai provider under the hood, so it also works in any laravel/ai app without Tackle.

Two ways to authenticate

GROK_AUTH selects the mode (auto by default: subscription when a Grok CLI sign-in exists, otherwise api-key). If you want the recommended path unconditionally, set GROK_AUTH=api-key.

Installation

The easiest path from a Tackle app:

Or via Composer directly:

The service provider registers a grok driver with laravel/ai automatically — no config/ai.php edits required (add a 'grok' => ['driver' => 'grok'] entry if you prefer it explicit).

API-key mode (recommended)

Get a key from console.x.ai and set it:

This is the stock, documented xAI integration path — the same api.x.ai endpoint and API-key auth xAI publishes for building custom apps. Billing is metered per token, so pin rates in config/tackle.php under pricing.models to keep budget enforcement meaningful.

Subscription mode: the honest version

Subscription mode runs the agents on your grok.com plan by reusing the Grok CLI's sign-in — the same ~/.grok/auth.json session token, sent to the CLI backend (cli-chat-proxy.grok.com).

What you should know before using it:

• This mimics the official Grok CLI. The CLI backend rejects requests that don't identify as the CLI (HTTP 426, "your Grok CLI version is outdated"), so this mode sends the same client-version headers the Grok CLI sends. It is not a documented third-party integration path — xAI's documented paths for custom apps are the API and Agent mode/ACP. Treat subscription mode as best-effort.
• xAI can change or gate it at any time. Every endpoint and header lives in config (GROK_BASE_URL, GROK_CLIENT_VERSION, …), so a change is an .env edit rather than a package release — but there is no guarantee it keeps working, and plan usage is subject to your grok.com subscription's terms.
• The Grok CLI owns the session. This package reads the token read-only and never mints one. The CLI refreshes its own session in the background; when it lapses, run grok login.

If your usage matters, prefer api-key mode, or confirm subscription-backend use with xAI developer support first.

Configuration

Everything is env-tunable; publish the config for the full list:

Tackle integration

When subscription mode is active and grok is the active provider, the CLI backend's models are registered in Tackle's pricing catalog at $0/MTok — the budget tracker stays accurate because your plan covers usage. The zero rates apply only when this provider is active, so an api-key setup keeps real rates. A leftover claude-*/gpt-* model default from another provider is swapped for the Grok default automatically.

How it works

laravel/ai's xAI gateway already speaks the Responses API. This package extends it with a GrokProvider that:

• in api-key mode, is the stock xAI provider — api.x.ai, Authorization: Bearer <key>, stock model defaults;
• in subscription mode, swaps the bearer for the Grok CLI session token, points the base URL at the CLI backend, and (via GrokGateway) attaches the client-version headers that backend requires.

Development

License

MIT