How pavankalyanv5/claude-code-privacy-proxy works
This is a local privacy proxy for Claude Code: it transforms sensitive request content and metadata before forwarding requests, then restores reversible aliases in streamed responses so local tools can still operate on real values. The runtime also supports optional IP-masking egress, residue scrubbing, durable audit records, retention, and a local dashboard. The graph emphasizes documented capabilities and relationships visible in excerpts, the README, or the SOURCE INDEX; unsampled wiring is omitted where it cannot be established.
Main entry points: start.js Runtime Startup · server.js Local Proxy · pipeline.js Render Pipeline · egress.js Egress Tunnel
Components 24
Proxy Runtime
- Runtime Startup
src/start.js - Local Proxy
src/server.js
Privacy Transforms
- Redaction Rules
src/rules.js - Render Pipeline
src/pipeline.js - Redaction Spans
src/spans.js - Identity Aliases
src/aliases.js - Metadata Normalization
src/normalize.js - Outbound Walk
src/walk.js - Inbound Resolver
src/resolver.js - Header Sanitization
src/headers.js - Stream Restoration
src/sse.js
Network Egress
- Egress Tunnel
src/egress.js - Tunnel Discovery
src/providers.js - Proxy Pool
src/pool.js
Residue Governance
- Residue Scrubber
src/scrub-residue.js - Clean-File Index
src/residue-index.js - Residue Job Log
src/residue-log.js - Retention Policy
src/retention.js
Operations and Audit
- Audit Dashboard
src/dash.js - Process Supervisor
src/supervise.js - Privacy Diagnostics
src/doctor.js - Audit Records
src/audit.js
Other components
- Claude Code
- Claude API
Connections 29
- Claude Code → Local Proxy: sends requests
README.md - Runtime Startup → Local Proxy: starts
src/start.js - Runtime Startup → Redaction Rules: loads
src/start.js - Runtime Startup → Outbound Walk: configures
src/start.js - Runtime Startup → Inbound Resolver: configures
src/start.js - Runtime Startup → Egress Tunnel: configures
src/start.js - Local Proxy → Claude API: forwards requests
README.md - Local Proxy → Stream Restoration: transforms streams
src/server.js - Local Proxy → Audit Dashboard: routes dashboard
src/server.js - Outbound Walk → Render Pipeline: renders outbound
src/pipeline.js - Inbound Resolver → Render Pipeline: uses shared config
src/pipeline.js - Render Pipeline → Redaction Spans: redacts text
src/pipeline.js - Render Pipeline → Identity Aliases: aliases identity
src/pipeline.js - Render Pipeline → Metadata Normalization: normalizes values
src/pipeline.js - Local Proxy → Header Sanitization: sanitizes headers
src/server.js - Inbound Resolver → Claude Code: restores tool values
README.md - Local Proxy → Egress Tunnel: tunnels upstream
- Tunnel Discovery → Egress Tunnel: supplies endpoints
src/providers.js - Proxy Pool → Egress Tunnel: supplies proxies
src/pool.js - Residue Scrubber → Render Pipeline: reuses transforms
src/scrub-residue.js - Residue Scrubber → Clean-File Index: marks clean files
src/scrub-residue.js - Residue Scrubber → Residue Job Log: records passes
src/residue-log.js - Retention Policy → Residue Job Log: limits history
- Audit Dashboard → Residue Job Log: shows job history
src/dash.js - Runtime Startup → Retention Policy: configures
src/start.js - Runtime Startup → Audit Records: configures
src/start.js - Privacy Diagnostics → Redaction Rules: checks rules
src/doctor.js - Privacy Diagnostics → Residue Job Log: checks audit history
src/doctor.js - Runtime Startup → Process Supervisor: configures supervision
src/start.js