grokdrive is an unofficial Claude Code extension: a dispatcher CLI, an optional
PreToolUse gate hook (strict mode only), and a doctrine skill. It routes heavy work
to the Grok Build CLI headless with --always-approve — an auto-approved, autonomous
shell over the working directory. Treat dispatched specs as capable of arbitrary local
execution.
--always-approvebody — everygrokdrivedispatch can run shell, edit files, and call tools under the Grok Build CLI. Do not dispatch secrets or sensitive code without redaction. Prefer sandbox/worktree isolation when the working tree is high-stakes.- Default is soft, not a sandbox — soft mode does not constrain Claude tools.
Strict mode (
grokdrive on --strict) constrains Claude's four mutation tools (Write/Edit/MultiEdit/NotebookEdit) only. Neither mode stops Bash-based file writes, MCP writes, or writes by spawned sub-agents. - No credentials in the repo — never commit
.env, tokens, session dumps, or real secrets. State lives under~/.claude/.grokdrive-state/(local only). - External body is a cloud service — Grok runs remotely. Do not put credentials, private keys, or unreleased IP into specs without redaction.
Open a GitHub issue with the security label, or email the maintainers via the
org contact on GitHub. Do not attach real secrets; use synthetic fixtures.
Best-effort on the latest main / latest release tag only. There is no paid SLA.
| Asset | Risk | Mitigation |
|---|---|---|
Working tree under --always-approve |
Arbitrary local execution by Grok body | Spec hygiene; sandbox/worktree; review diffs before merge |
| Claude mutation tools (strict only) | Advisor hand-edits work files | PreToolUse gate when strict: true |
| Soft mode | No edit fence | Intentional; user discretion |
| Bash / MCP / sub-agent writes | Always possible | Skill doctrine; not hook-enforced |
| Specs / artifacts on disk | Secret re-surface in prompts | Redact before dispatch; keep state out of git |
| Install | Path confusion / settings.json surgery | Symlinks only into this repo; backup before first edit |