dedene GitHub avatar

vpngrok

dedene

vpnGrok runs xAI's Grok CLI inside a Docker container whose network is exclusively routed through a gluetun VPN tunnel, providing a kill-switch and a convenient wrapper command that works from any project directory.

Stars

10

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-11

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves Grok's regional unavailability and real-IP leak risks simultaneously with a clean Docker Compose setup that supports 40+ VPN providers and includes a kill-switch verification step.

Who it is for

  • Developers in regions where Grok is not available
  • Privacy-conscious Grok users who want VPN-guaranteed traffic
  • Docker and Docker Compose users looking for neat isolation patterns
  • CLI tool users who want to run Grok from any project directory

Use cases

  • Running Grok from any project under WORKSPACE_ROOT without manual VPN setup
  • Securely accessing Grok from a region that blocks it, with full traffic via VPN
  • Sharing Grok sessions and skills between native and container-ized usage
  • Verifying the kill-switch works by stopping the VPN container and confirming network loss

Strengths

  • Kill-switch ensures the dev container loses all network when the VPN tunnel drops, preventing IP leaks
  • Supports 40+ VPN providers via gluetun; switching requires only .env changes
  • Scoped workspace mount (WORKSPACE_ROOT) limits container access to only project directories, reducing blast radius
  • Sessions and skills are shared with the host via bind mounts, enabling seamless /resume across native and container runs

Considerations

  • The `vpngrok` command only works inside WORKSPACE_ROOT; mounting broader directories requires manual tradeoffs and may trigger Docker Desktop warnings
  • First run requires manual login (browser flow or XAI_API_KEY); Mullvad's key rotation means credentials become invalid on config regeneration
  • All projects share one container, one Grok login, and one VPN exit server – no per-project isolation

README quick start

Usage

Description

Run xAI's Grok CLI from any project, with all traffic routed through a VPN (Docker + gluetun, Mullvad by default)

Related repositories

Similar projects matched by category, topics, and programming language.

bjan
Featured
bjan GitHub avatar

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI & Machine LearningAI Agents
9
S40911120
Featured
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI & Machine LearningLarge Language Models
67
PromptPartner
PromptPartner GitHub avatar

agentsmith

AgentSmith is a portable, battle-tested operating system for AI coding agents that provides disciplined rules, tools, memory, and feedback loops to turn vibe-coded demos into production-grade software.

Shell
255