gitwtfhub

wtf is grok-upload-guard?

reedchan7/grok-upload-guard — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 1/5Setup · easy

TL;DR

grok-upload-guard scans your machine for signs that Grok Build CLI uploaded your whole repo or session traces, and can patch its config to turn those uploads off.

Mindmap

mindmap
  root((grok-upload-guard))
    What it does
      Scans local logs
      Detects upload evidence
      Patches config file
      Creates backup first
    Tech stack
      Python
    Use cases
      Privacy self-check
      Config hardening
      Post-fix verification
    Limits
      Local evidence only
      No wire capture
      Cannot block model reads

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

Why would anyone build with this?

REASON 1

Check local logs for evidence that Grok Build CLI has uploaded a whole repo or session trace.

REASON 2

Patch the Grok config file to disable telemetry, trace upload, and codebase upload settings.

REASON 3

Review a summary of upload counts, decisions, and affected repos recorded on your machine.

REASON 4

Confirm after a fix that a new Grok Build session no longer triggers whole-repo uploads.

What's in the stack?

Python

How it stacks up

reedchan7/grok-upload-guard0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity1/52/54/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Runs directly via curl-piped script or a plain Python 3.10+ install with no dependencies.

No license information is stated in the README.

Wtf does this do

grok-upload-guard is a small Python tool for people who use Grok Build CLI and want to check whether it has been uploading their whole repository or session traces without them noticing. It does two things: it scans local log files under a hidden .grok folder for evidence that uploads already happened on your machine, and it can patch the Grok config file to turn off whole-repo and session-trace upload settings. The README is careful to say this project did not discover the upload behavior itself. It points to independent wire capture research using tools like mitmproxy, recovered git bundles, and observed multi-gigabyte uploads to a storage endpoint, which has since been discussed widely on Reddit, Hacker News, and elsewhere, and which the Grok account has reportedly acknowledged as intentional. What this tool adds is a way to check your own machine, harden your local config, and reduce further uploads. It makes clear that a clean local scan does not disprove the wider wire capture findings, and a positive local finding is not the same as running a full packet capture yourself. Running detect reads log files, session signal files, the config file, and the auth file to report things like how many upload starts and enqueued files were recorded, what reasons were logged for enabling or disabling uploads, and the current privacy opt-out status. Running fix rewrites specific keys in the config file, such as turning off telemetry, feedback, and trace upload settings, and it creates a timestamped backup of the config first. A combined detect-then-fix mode is also available. The tool makes no network calls itself and needs nothing beyond Python 3.10 or newer. It is explicit about its limits: it only reads local artifacts, so it cannot prove or disprove what happens on the network, and it cannot stop the model from receiving file contents that the agent is intentionally asked to read, such as an environment file. The author recommends starting a new Grok Build session after applying the fix and re-running detect to confirm the change took effect, and treating any secrets used in a workspace where Grok Build ran as potentially exposed.

Yoink these prompts

Prompt 1
Show me how to run grok-upload-guard.py detect to check my machine for Grok Build CLI upload evidence.
Prompt 2
Explain what the fix command changes in ~/.grok/config.toml and why it creates a backup first.
Prompt 3
What log files and signals does this tool scan under the ~/.grok directory?
Prompt 4
Help me set the GROK_TELEMETRY_ENABLED and related environment variables after running the fix.

Frequently asked questions

wtf is grok-upload-guard?

grok-upload-guard scans your machine for signs that Grok Build CLI uploaded your whole repo or session traces, and can patch its config to turn those uploads off.

What language is grok-upload-guard written in?

Mainly Python. The stack also includes Python.

What license does grok-upload-guard use?

No license information is stated in the README.

How hard is grok-upload-guard to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is grok-upload-guard for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.