VibeKit’s proxy server intercepts HTTP/HTTPS traffic between coding agents and their API endpoints, providing real-time data redaction and request logging. The proxy sits between your agents and external services, automatically removing sensitive data before it reaches your terminal or logs.

​
Quick Start

# Start proxy with npx (no installation needed)
npx @vibe-kit/proxy start

# Or through VibeKit CLI
vibekit proxy start

# Check server status
npx @vibe-kit/proxy status

​
Essential Commands

# Core operations
npx @vibe-kit/proxy start       # Start proxy server
npx @vibe-kit/proxy stop        # Stop proxy server  
npx @vibe-kit/proxy status      # Check server status

# With options
npx @vibe-kit/proxy start -p 3000    # Custom port
npx @vibe-kit/proxy start -d         # Run as daemon

​
Installation

Run directly with npx (recommended) or install globally for frequent use: 
# Direct usage (no installation)
npx @vibe-kit/proxy start

# Global installation
npm install -g @vibe-kit/proxy
vibekit-proxy start

# Through VibeKit CLI
vibekit proxy start --port 8080

​
Configuration

VariableDescriptionDefault
PORT or VIBEKIT_PROXY_PORTProxy server port8080
VIBEKIT_PROXY_TARGET_URLTarget API URL for routing-

​
Health Monitoring

# Check health status
curl http://localhost:8080/health
# Returns: {"status": "healthy", "uptime": 3600, "timestamp": "2024-01-15T10:30:00.000Z", "requestCount": 142}

​
Docker Deployment

# Build from source (published image coming soon)
docker build -t vibekit-proxy packages/proxy
docker run -p 8080:8080 -e PORT=8080 vibekit-proxy
Docker Compose for production: 
version: '3.8'
services:
  vibekit-proxy:
    build: packages/proxy
    ports: ["8080:8080"]
    environment:
      - PORT=8080
    restart: unless-stopped

​
Data Redaction

The proxy automatically detects and removes 70+ patterns of sensitive information:
  • API Keys: OpenAI (sk-proj-), Anthropic (sk-ant-), GitHub (ghp_), AWS, Google, Slack, Stripe
  • Personal Data: Email addresses, credit card numbers, database connection strings, JWT tokens
  • Secrets: SSH private keys, SECRET_KEY, API_SECRET, CLIENT_SECRET values, passwords
The proxy processes streaming responses (SSE) in real-time, accumulating chunks to ensure complete pattern matches before redaction.

​
Cloud Deployment

# Google Cloud Run (after building and pushing your image)
gcloud run deploy vibekit-proxy --image vibekit-proxy --port 8080

# AWS ECS, Azure Container Instances also supported

​
Using with Agents

# Run agents through proxy
vibekit claude --proxy http://localhost:8080 "Create a React component"
vibekit gemini --network "Create a web scraper"

# Proxy starts automatically when needed
vibekit claude "Generate API documentation"

​
Status Monitoring

# Check proxy status
vibekit proxy status
# Output: Port 8080: ✅ RUNNING, Uptime: 1800s, Requests: 45

# View in dashboard
vibekit dashboard

​
Troubleshooting

# Port already in use
npx @vibe-kit/proxy stop -p 8080        # Stop existing proxy
npx @vibe-kit/proxy start -p 3000       # Use different port

# Connection issues  
npx @vibe-kit/proxy status              # Verify proxy is running
curl http://localhost:8080/health # Test health endpoint

# Enable debug logging
VIBEKIT_DEBUG=1 npx @vibe-kit/proxy start
The proxy handles shutdown signals gracefully (Ctrl+C, SIGTERM) for clean container deployments.

​
Next Steps

Built-in Redaction

Learn more about VibeKit’s data redaction capabilities

Observability

Monitor proxy performance and analytics

Environment Variables

Configure proxy settings and API endpoints

Configuration Files

Set up persistent proxy configuration