The definitive
CLI toolkit for
Grok Build

12+ production-grade utilities.
Sessions, skills, backups, analytics, MCP, plugins & hooks.
Beautiful • Safe-by-default • Scriptable with --json

Sole author & maintainer: Cobus Greyling
View on GitHub
Star the repo • See the code • Contribute
github.com/cobusgreyling/grok-build-cli-utilities →
Grok Build CLI Utilities banner
12+
Power commands & subcommands
7
Core utility groups
100%
Safe-by-default (dry-run)
--json
Scriptable on every command

See what grok-utils can actually do.

Most CLI tools are toys or thin wrappers. grok-utils ships real, daily-driver power tools that operate directly on your ~/.grok data — with beautiful output, ironclad safety defaults, and first-class JSON support for scripting and dashboards.

Everything here was built to make you dramatically more productive with Grok Build. Zero mocks. Real data only.

THE TOOLKIT

The Utilities

sessions
Core

Advanced session browser, search (FTS), deep analysis, export (md/html/json), resume, and safe pruning.

grok-utils sessions list --project acme --limit 20
grok-utils sessions analyze 019e87 --deep
skills
Core

Full lifecycle: discover (priority-aware), create high-quality starters, validate, pack/unpack for sharing.

grok-utils skills create deploy --desc "..."
grok-utils skills validate ./my-skill
backup
Core

Industrial-strength backups with SHA-256 manifests. Selective sessions by project. Extremely safe restore (dry-run default).

grok-utils backup create --include-sessions
usage
Analytics

Stunning reports, sparklines, timelines, model breakdowns + rough cost estimates. Group by project or model.

grok-utils usage report --by project --top 8
grok-utils usage cost --by model
mcp
Ecosystem

Inspect config, doctor PATH checks, test servers, and easy example injection for filesystem, GitHub, SQLite etc.

grok-utils mcp doctor
worktree + memory
Hygiene

Correlate git worktrees with sessions (find zombies). Cross-session memory explorer and search.

grok-utils worktree prune-orphaned --dry-run
Plus plugins, hooks, config, logs, and the excellent doctor health check. See every command →
NOT THEORY

Real work. Real productivity.

These tools operate directly against your live ~/.grok data with rich terminal output and zero configuration.

FLAGHIP

Session forensics & export

List, search (leveraging Grok's own FTS), deep analyze with signals + rewinds, export beautiful markdown or self-contained HTML for reviews and handoff.

grok-utils sessions analyze 019e87 • grok-utils sessions export ... --format html
DAILY DRIVER

Usage + Cost awareness

Visual reports with unicode bars and sparklines. Model and project breakdowns. Rough cost estimates to spot expensive work early.

grok-utils usage report --by project • grok-utils usage cost --by model
30 SECONDS

Get started

# Recommended (isolated) pipx install grok-build-cli-utilities # Or with pip pip install grok-build-cli-utilities grok-utils doctor grok-utils --help

Works directly with your real ~/.grok. Supports --grok-home / GROK_HOME. Every destructive action defaults to --dry-run.

Philosophy: Safe first. Beautiful & fast. Scriptable. Real data only. Minimal deps.
MIT © 2026 Cobus Greyling • GitHubMore on the approach
NOT AFFILIATED WITH xAI • BUILT TO MAKE GROK BUILD USERS DRAMATICALLY MORE PRODUCTIVE