whatisgithub

What is grok-network-monitor?

weklund/grok-network-monitor — explained in plain English

Analysis updated 2026-05-18

15ShellAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A toolkit that intercepts network traffic from xAI's Grok Build CLI to show exactly what data it sends to xAI's servers.

Mindmap

mindmap
  root((repo))
    What it does
      Intercepts CLI traffic
      Classifies requests
      Logs findings
    Tech stack
      mitmproxy
      Python
      Bash
    Use cases
      Check past uploads
      Block telemetry
      Verify privacy claims
    Audience
      Developers
      Privacy researchers

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 build with it?

USE CASE 1

Check whether your own repositories were ever uploaded to xAI using the included detect-exfil script.

USE CASE 2

Monitor Grok Build's network traffic after each update to see if upload behavior changed.

USE CASE 3

Block analytics tracking domains to stop telemetry without breaking the CLI.

USE CASE 4

Verify claims about privacy settings and environment variables by capturing real traffic.

What is it built with?

ShellmitmproxyPythonBash

How does it compare?

weklund/grok-network-monitoraduskelebe/diffpilotamrit-regmi/immich_edge
Stars151515
LanguageShellShellShell
Setup difficultymoderateeasyhard
Complexity3/52/54/5
Audiencedeveloperdeveloperops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs mitmproxy installed with CA trust configured plus a working Grok CLI install.

So what is it?

Grok Network Monitor is a research toolkit that watches network traffic from xAI's Grok Build command line tool to see exactly what data it sends back to xAI's servers. It works by routing the grok CLI's traffic through mitmproxy, a tool that intercepts and inspects network connections, then classifying and logging what it finds. The project documents a set of findings about Grok Build's behavior. The CLI ships with working code that can package an entire git repository as a bundle and upload it to xAI's storage. That upload path is currently switched off by a setting controlled from xAI's servers, not by anything on the user's machine, so xAI could turn it back on at any time without a software update. The README also reports that an environment variable meant to disable data collection has no measurable effect on network traffic, that a privacy opt out setting only affects how long data is kept rather than whether it is sent, and that any file grok reads including files containing secrets is transmitted in plain text to xAI as context for the AI. It also counts more than fourteen tracking events sent per prompt to two separate analytics destinations. Alongside these findings the README gives practical advice: keep secrets out of repositories where grok runs, use gitignore to exclude sensitive files from any bundle upload, run the included detect-exfil script to check whether your own repositories were uploaded in the past, and block the analytics domain in your hosts file if you want to stop tracking without breaking the tool. Enterprise users are told that a zero data retention setting provides a second safeguard against uploads even if the remote flag changes. To use it you need macOS or Linux, mitmproxy, a working Grok CLI install, Python 3.8 or later, and bash, then run the included setup and test scripts. The project also raises a list of unanswered questions it has sent to xAI about retention, consent, and the scope of any past uploads.

Copy-paste prompts

Prompt 1
Help me run the setup.sh script in grok-network-monitor and explain what mitmproxy is doing.
Prompt 2
Walk me through interpreting the output of detect-exfil.sh in this repo.
Prompt 3
Explain the findings table in this README about Grok Build's data transmission.
Prompt 4
Show me how to block api.mixpanel.com in /etc/hosts based on this repo's instructions.

Frequently asked questions

What is grok-network-monitor?

A toolkit that intercepts network traffic from xAI's Grok Build CLI to show exactly what data it sends to xAI's servers.

What language is grok-network-monitor written in?

Mainly Shell. The stack also includes Shell, mitmproxy, Python.

How hard is grok-network-monitor to set up?

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

Who is grok-network-monitor for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.