AI repository intelligence

FR-AI / ANALYSIS

Why it is worth attention

It provides a simple, real-time security mechanism to prevent accidental exposure of Claude when a VPN drops, with cross-platform support and proactive CI testing.

Who it is for

Developers who run Claude locally and need VPN-based security
Remote workers concerned about IP leakage during VPN disconnections
macOS and Windows power users who want a visual terminal monitor
Security-conscious users automating Claude process management

Use cases

Automatically stopping all Claude processes when the VPN unexpectedly disconnects
Quickly viewing the current count of running Claude processes
Manually killing all Claude processes with a single keystroke
Monitoring VPN connectivity status alongside Claude process activity

Strengths

Lightweight with no external dependencies beyond built-in OS tools
Cross-platform support for macOS and Windows via bash and PowerShell
Real-time updates every two seconds without filling terminal scrollback
Includes a non-destructive self-test mode on Windows and CI verification

Considerations

May accidentally stop processes whose command contains 'claude' but aren't Claude
VPN detection may not cover all VPN providers or custom configurations
No user-configurable whitelist or blacklist; always auto-kills when no VPN is detected

README quick start

Claude Watch

Claude Watch is a lightweight, interactive macOS and Windows terminal monitor for Claude processes and VPN connectivity.

Features

Refreshes every two seconds without filling Terminal scrollback.
Shows the number of running processes whose command contains claude.
Detects system-managed VPNs and common third-party VPN adapters.
Automatically stops every matching Claude process when no VPN is detected.
Lets you manually stop all matching processes by pressing k.
Exits cleanly with x, q, or Control-C.

[!WARNING] Claude Watch intentionally terminates processes automatically whenever its VPN checks report no connection. Because matching is case-insensitive and command-line based, it may also stop other processes whose command contains claude.

macOS

Requirements: macOS, its included Bash version, and a Terminal that supports ANSI escape sequences.

Install and run:

git clone https://github.com/omidkorat/claude-watch.git
cd claude-watch
chmod +x claude-watch.sh
./claude-watch.sh

Windows

Requirements: Windows 10 or 11 and Windows PowerShell 5.1 or later.

Clone the repository, open PowerShell in its folder, and run:

powershell -NoProfile -ExecutionPolicy Bypass -File .\claude-watch.ps1

The execution-policy option applies only to that invocation and does not change the system policy.

Controls

Press k to stop every detected Claude process.
Press x or q to exit.

Status colors

Green: VPN connected, or no Claude processes detected.
Yellow: Claude is running while a VPN is connected.
Red: VPN disconnected, auto-kill armed, or an automatic stop was triggered.

VPN detection on macOS

Claude Watch checks, in order:

Connected VPN services reported by scutil --nc list.
Active utun tunnel interfaces reported by scutil --nwi.
Full-tunnel routes using utun, tun, tap, ppp, or ipsec interfaces, including OpenVPN's 0/1 plus 128/1 routing pattern used by VyprVPN.

Some Apple services and third-party networking tools may also use tunnel interfaces. Review the script's behavior for your setup before relying on it as a security control.

VPN detection on Windows

The PowerShell version checks, in order:

Connected Windows VPN profiles reported by Get-VpnConnection.
Active adapters reported by Get-NetAdapter whose names iden

Description

A macOS monitor that protects Claude usage with VPN-aware automatic process control.

Related repositories

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

Korben00

no-gdid

no-gdid is a PowerShell-based tool to audit and block the Windows Global Device Identifier (GDID), a per-account device ID used by Microsoft and shared with law enforcement, based on verified reverse engineering.

PowerShell

241

LewdM3at

PC-Cartridge-System

A hobby project that turns 2.5" SATA SSDs into physical game cartridges for your Steam library, automatically launching games or custom actions when inserted.

PowerShell

219

gd03gd031

Windows-GDID-Changer

A PowerShell script for Windows 10/11 that regenerates the Global Device Identifier (GDID) by removing local session tokens and forcing a new device registration with Microsoft servers.

PowerShell

149