Zero-bypass Windows Service egress gate & native GPUI desktop guardian for AI desktop apps and CLIs
Architecture note: Starting from v4.0.0, ClaudeGuard has been rebuilt from a Tauri 2 single binary into a Windows Service daemon + native GPUI client (
claudeguard-daemon.exe+claudeguard-gui.exe+claudeguard-cli.exe) — zero WebView2 dependency, zero daily UAC prompts, and crash-safe WAL rollback. The legacy v3 codebase (including the community macOS preview) remains preserved on thev3branch and tagv3.12.5.
ClaudeGuard is a read-only, fail-closed network-egress gate for AI desktop apps on Windows: it independently probes each target's real exit IP, region, and reachability strictly through your configured local proxy (never falling back to direct and never altering your proxy routing rules), blocks app launches unless all checks pass, isolates non-compliant apps via Windows Firewall + process termination + optional network cut, and restores everything deterministically via a Write-Ahead Recovery Journal (WAL).
AI desktop clients (Claude Desktop, ChatGPT / Codex, Antigravity IDE) and terminal agents (Claude Code CLI, Codex CLI) are sensitive to exit IP reputation and supported regions, whereas local proxy clients typically expose a single shared tunnel that can silently drift, drop into direct connection, or be bypassed via UDP:443 QUIC, plaintext DNS:53 / DoH, IPv6, or background helpers (e.g., Antigravity's language_server subprocesses and MCP child tools).
ClaudeGuard never runs a proxy, switches nodes, or rewrites your proxy rules. It verifies the real outbound environment before and while your AI tools talk to the network — stopping leakage before an unauthorized request ever hits the wire.
All screenshots below are real HiDPI renders captured directly from claudeguard-gui.exe (rendered natively via Rust + Zed gpui).
![]() Antigravity Proxy Guardian — Inspects yuaotian/antigravity-proxy ( version.dll integrity, config.json port match, language_server hook), blocks launch if overwritten on update & hot-repairs in 1 click
|
![]() Timezone & Region Alignment — Aligns Windows timezone & default location coordinate to your verified egress city without touching proxy nodes; backs up originals for lossless rollback |
![]() Audit & 24h Compliance Timeline — Interactive 48×30m bucket timeline, Ctrl+K instant search, level filter pills & 1-click redacted .zip diagnostics bundle export
|
![]() Update Radar (10 Components) — Strictly read-only checks through local proxy for ClaudeGuard, antigravity-proxy, Claude/Codex Desktop & CLI, Antigravity IDE & antigravity-desktop-cn
|
![]() Antigravity Plugins & Updates Modal — Local vs. upstream tracking for antigravity-usage-monitor, agy-capsule, antigravity-desktop-cn & antigravity-proxy |
![]() Desktop & Alert Preferences — 6 event toggles, 1-click critical-only preset, privacy-by-default egress IP/hostname redaction & Session-0 → Session-1 native Windows toast relay |

Feishu / Lark Bot — HMAC-SHA256 signature verification, Windows DPAPI credential encryption, persistent offline retry queue & redacted test delivery
- Privilege-Separated 3-Binary Design:
claudeguard-daemon.exe(ClaudeGuardService, WindowsLocalSystem): owns firewall COM rules, process termination/orphan cleanup, OS timezone/location writes,antigravity-proxyinjection checks, proxy-only probing, and WAL recovery. Starts automatically at boot.claudeguard-gui.exe(asInvoker, normal user token): native GPUI interface with zero WebView2 overhead, spawning guarded AI apps with the user's normal desktop token, relaying desktop toasts in Session-1, and idling at ~0 VRAM in--traymode.claudeguard-cli.exe: scriptable--checkpre-flight check,--statusdiagnostics, and--restoreemergency recovery (with offline WAL fallback if the service is stopped).
- Hardened Named Pipe IPC (
\\.\pipe\ClaudeGuardV4):- Secured via SDDL ACL (
D:(A;;GA;;;SY)(A;;GA;;;BA)(A;;GRGW;;;AU)) +PIPE_REJECT_REMOTE_CLIENTS(blocks remote SMB access, lets normal interactive users talk to Session-0 without daily UAC prompts).
- Secured via SDDL ACL (
- Write-Ahead Recovery Journal (
journal.json):- Every OS mutation (per-app firewall block, manual lockdown, global outbound cut, NIC disable, OS timezone/location alignment) persists and flushes a WAL transaction before changing Windows state. Startup self-healing and
--restoreexecute deterministic, verified idempotent cleanup (list_managed_firewall_rules == 0).
- Every OS mutation (per-app firewall block, manual lockdown, global outbound cut, NIC disable, OS timezone/location alignment) persists and flushes a WAL transaction before changing Windows state. Startup self-healing and
- Proxy-Only Egress Probing (Zero Direct Fallback):
- Every target binds its own domain:
Claude→claude.ai/cdn-cgi/trace,Codex→chatgpt.com/cdn-cgi/trace,Antigravity→ reachability ofdaily-cloudcode-pa.googleapis.com(cloudcode-pa.googleapis.com),Local Egress(off by default) →cloudflare.com/cdn-cgi/trace, plus custom HTTP trace / JSON IP / page region / reachability targets. - All probes and update checks strictly obey
ProbeRoute(configured proxy or verified TUN); if no proxy access exists, ClaudeGuard never probes direct with your home IP.
- Every target binds its own domain:
- 10-Component Read-Only Update Radar:
- Tracks
ClaudeGuard(daha1216/ClaudeGuard),antigravity-proxy(yuaotian/antigravity-proxy),Claude Desktop(MSIX),Claude Code CLI(npm),ChatGPT / Codex Desktop(MSIX),Codex CLI(npm),Antigravity IDE(latest-x64-win.yml),Antigravity 中文汉化引擎(Silas-02/antigravity-desktop-cn),antigravity-usage-monitor(yuhuan-dev/antigravity-usage-monitor), andagy-capsule(Lumidarin/agy-capsule). Read-only checks only — never auto-overwrites installed clients or plugins.
- Tracks
Grab the latest release from GitHub Releases:
- Installer —
ClaudeGuard-v4.1.0-setup.exe(Recommended)- Registers & starts
ClaudeGuardService(LocalSystem, auto-start at boot) and adds normal-privilege tray autostart (claudeguard-gui.exe --tray) so daily usage requires 0 UAC prompts. - Upgrading from v3 (
v3.x): shares the same Inno SetupAppId, gracefully stopsClaudeGuard.exe, cleans up the legacy v3HKCU\...\Run\ClaudeGuardentry, and automatically migrates legacyconfig.json(writing a one-timeconfig.v3.bak.jsonbackup). - Uninstall cleanly removes the Windows Service & binaries while deliberately preserving configuration and journals in
%ProgramData%\ClaudeGuardand%APPDATA%\ClaudeGuard.
- Registers & starts
- In-App Upgrade Bridge —
ClaudeGuard-v4.1.0-upgrade.exe(Forv3.xAuto-Update)- Matched automatically by legacy
v3.xclients during 6-hour background checks and manual "Check for updates": copies%APPDATA%\ClaudeGuard\config.jsoninto%ProgramData%\ClaudeGuard\config.json, stages and launches the v4 installer cleanly, waits for completion, and removes legacyClaudeGuard.exe, shortcuts, and staging residue after installation succeeds.
- Matched automatically by legacy
- Portable —
ClaudeGuard-v4.1.0-portable.zip- Contains
claudeguard-daemon.exe,claudeguard-cli.exe, andclaudeguard-gui.exe. Runclaudeguard-daemon.exe --console(elevated) or register the service via--install-service --start, then launchclaudeguard-gui.exeas your normal user.
- Contains
Verify integrity anytime against the release
SHA256SUMS.txt.
claudeguard-cli.exe --check # Query daemon compliance JSON; exit 0=pass, 2=not passed
claudeguard-cli.exe --check --recheck # Trigger fresh probe round first, then print compliance JSON
claudeguard-cli.exe --restore # Emergency disarm & full firewall/network/env restore (online or offline WAL fallback)
claudeguard-cli.exe --status # Print daemon service, WAL journal & live snapshot status JSONclaudeguard-daemon.exe --install-service --start # Register & start LocalSystem ClaudeGuardService
claudeguard-daemon.exe --uninstall-service # Stop & unregister Windows Service
claudeguard-daemon.exe --service-status # Query SCM status JSON
claudeguard-daemon.exe --console # Run in foreground console mode (development/portable)claudeguard-gui.exe # Open Mode B Console (normal user privilege)
claudeguard-gui.exe --tray # Start resident in system tray (0 windows, 0 VRAM)
claudeguard-gui.exe --hud # Open Mode A compact Tray Quick HUD (398x432)
claudeguard-gui.exe --demo pass # Standalone UI demo (pass | trip | disarmed | wizard), zero daemon needed- Primary daemon state lives in
%ProgramData%\ClaudeGuard\(cascading to%APPDATA%\ClaudeGuard\→%LOCALAPPDATA%\ClaudeGuard\):config.json: v4 configuration (auto-migrated cleanly from v2/v3 withconfig.v{ver}.bak.jsonpreserved).journal.json: crash-safe WAL recovery journal for idempotent startup/offline rollback.feishu.json: WindowsDPAPI(LocalMachine) encrypted Webhook URL & signing secret, plus offline retry queue.env_backup.json: pre-alignment snapshot of original Windows timezone & default location coordinates.
- Privacy defaults:
- Outbound desktop & Feishu alerts redact egress IP & hostname by default (
include_egress: false). - One-click
.zipdiagnostic bundle export (Audittab) automatically strips usernames, local absolute paths, and the last two IPv4 octets. - Zero third-party telemetry and zero direct fallback probing when proxy access is unavailable.
- Outbound desktop & Feishu alerts redact egress IP & hostname by default (
Requires Rust (1.98+, verified on rustc 1.99.0), Windows 10/11 SDK, and Inno Setup 6 (for .exe installer packaging):
# 1. Core workspace (protocol, core, platform, daemon, cli) — 188 tests
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace --locked
# 2. Native GPUI desktop client (cg-gui) — 25 tests (incl. live daemon pipe E2E)
cargo clippy --locked --manifest-path crates/cg-gui/Cargo.toml --all-targets -- -D warnings
cargo test --locked --manifest-path crates/cg-gui/Cargo.toml
# 3. Stage Release binaries, Inno Setup installer, portable zip & SHA256SUMS.txt
pwsh -NoProfile -ExecutionPolicy Bypass -File make-release.ps1See CONTRIBUTING.md, CHANGELOG.md, and SECURITY.md for engineering conventions and test fixture rules.
- Core engine, daemon, CLI & Windows platform layer (
cg-protocol,cg-core,cg-platform,cg-daemon): MIT © 2026 daha1216 - Native GPUI desktop interface (
crates/cg-gui): Apache-2.0














