git404hub

what is grokdrive fr?

rennlabs/grokdrive — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

grokdrive is a Claude Code extension that forces implementation work through Grok Build CLI while keeping planning and review with Claude.

vibe map

mindmap
  root((grokdrive))
    What it does
      Blocks Claude edit tools
      Dispatches specs to Grok
      Verifies with external gate
      Session scoped mode
    Tech stack
      Shell
      Node.js
      Python
    Use cases
      Mechanical implementation
      Parallel dispatch
      Bug fixes with repro
    Requirements
      Claude Code
      Grok Build CLI
      node python3 bash

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Route mechanical implementation work like refactors and bug fixes to Grok while Claude keeps oversight.

VIBE 2

Enforce a hard gate that blocks Claude's own edit tools during a session so work goes through Grok instead.

VIBE 3

Dispatch several independent coding specs to Grok in parallel.

VIBE 4

Run an external verification command to confirm Grok's changes actually pass before trusting its summary.

what's the stack?

ShellNode.jsPython

how it stacks up fr

rennlabs/grokdrive123satyajeet123/bitnet-serverahloiscreamo/pod-search
Stars000
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires the Grok Build CLI installed and authenticated on your system PATH alongside Claude Code.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

grokdrive is an unofficial extension for Claude Code that splits coding work between two AI models. When turned on for a session, the Grok Build CLI does the actual implementation work while Claude stays in charge of planning, writing specs, reviewing, and verifying, without using its own file editing tools directly. The README describes this as a brain and body split: Claude is the brain making the judgment calls, and Grok is the body doing the typing. The way this is enforced is a hook that blocks Claude's own Write, Edit, MultiEdit, and NotebookEdit tools while the mode is active for that session. Instead, work is sent through a command called grokdrive, which passes a self-contained spec to Grok for execution. The README is direct that this hook only stops Claude's own edit tools, not file writes made through Bash commands, MCP tools, or spawned sub-agents, so it describes itself as strong friction and discipline rather than a full sandbox. Installing it requires Claude Code itself, the Grok Build command line tool on your system path, plus node, python3, and bash, since the installer and the gate script depend on all of them. After installing, the gate only takes effect in new Claude Code sessions started after that point. The tool includes commands to turn the mode on or off, check its status, dispatch a spec to Grok, dispatch several specs in parallel, and run a verification command against the actual code changes rather than trusting Grok's own summary. The README also lays out a routing guide for what kind of work should go to Grok versus stay with Claude: implementation from a frozen spec, mechanical refactors, bug fixes with a known reproduction, and test writing are suited to Grok, while design decisions, architecture, destructive operations, and review of Grok's own output are meant to stay with Claude. Configuration options include effort level, dispatch timeout, maximum turns per dispatch, and an environment variable that disables the gate entirely. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through installing grokdrive and arming it for a Claude Code session with the opus advisor model.
prompt 2
Explain what the grokdrive PreToolUse gate blocks and what it does not stop, like Bash file writes.
prompt 3
Help me write a self-contained spec for grokdrive that includes the goal, key paths, and proof command.
prompt 4
How do I configure GROKDRIVE_EFFORT and GROKDRIVE_TIMEOUT for a large dispatch?

Frequently asked questions

what is grokdrive fr?

grokdrive is a Claude Code extension that forces implementation work through Grok Build CLI while keeping planning and review with Claude.

What language is grokdrive written in?

Mainly Shell. The stack also includes Shell, Node.js, Python.

What license does grokdrive use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is grokdrive to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is grokdrive for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.