grok-code-headless — drive Grok Build CLI programmatically
Headless library to prepare, observe, and control the real Grok Build CLI/ACP (prompt acceptance, cancel, semantic turn events) the way other -headless packages wrap Claude/Codex.
Caution: review the findings below before installing.
CautionScan verdict · score 50/100
- Coverage
- full
- Checks run
- Rule-based pattern scan
- Files checked
- 128
- Findings
- 4
- Scanned
- 2026-11-01
Badges are rule-based checks, not guarantees: Safe means our rules found no obvious threat in the code we could read. Review code before installing.
Botlens score · 8 factors
50/100
Each factor is 0, ½ or 1, computed only from catalog fields (scan result, coverage, findings, script files, commit/SHA, author, last seen, install link). A heuristic summary, not a guarantee.
| Scan verdict | 0.5/1 | Caution | |
|---|---|---|---|
| Code coverage | 1/1 | full | |
| Rule findings | 0/1 | 5 matched | |
| No executable scripts | 0/1 | 95 script file(s) of 128 | |
| Pinned source | 1/1 | commit/SHA-256 recorded | |
| Named author | 0/1 | unknown | |
| Recently seen | 1/1 | last seen 2026-10-30 | |
| Install path | 0.5/1 | source URL only |
Scan details
- Findings
- reads environment variables (where API keys live) in src/GrokHeadless.native.live.test.ts: "…hout owning a process. const enabled = process.env.GROK_HEADLESS_NATIVE_LIVE === '1' const…"
- spawns shell commands or evaluates code in src/conditions/commandPermission.ts: "…/^([1-9])\s+\([\u25cf\u25cb]\)\s+(.+)$/.exec(row) return match ? [{ key: match[1]…"
- uploads data to a remote server in src/proxy/GrokResponsesProxy.system.test.ts: "…push(event) }) const result = await fetch(`${relay.info.proxyBaseUrl}/responses`, { method: 'POST', body: '{"input":"private prompt"}', h…"
- reads environment variables (where API keys live) in src/transcript/SessionDirEncoding.ts: "…g): string { return join(grokHome ?? (process.env.GROK_HOME || join(homedir(), '.grok')),…"
- Content SHA-256
- 351327a8bb59e3c3…
- Commit
- 97e30382a8
- Files
- .gitattributes
.gitignore
LICENSE
README.md
package-lock.json
package.json
+122
About
- Author
- Juliusolsson05 ↗
- Listed on
- github:RongleCat/awesome-grok-bot ↗
- Category (approx.)
- coding
- First seen
- 2026-10-30
- Last seen
- 2026-10-30
- URL
- github.com ↗