Quick Start Guide

Prerequisites

• Windows 10/11, macOS 12+, or Linux (Ubuntu, Debian)
• Administrator / root access for certificate installation
• Internet connection for license validation

1. Download Bleep

Get the installer for your operating system from the downloads page.

• Windows: .msi or .exe installer
• macOS: .dmg file (Universal: Intel + Apple Silicon) (coming soon)
• Linux: .AppImage, .deb, or .rpm package

2. Get your license key

Sign up for an account and copy your license key from Dashboard → Licenses.

• Create an account with your work email
• Choose your plan and complete signup
• Copy your license key (format: LIC-XXXX-XXXX-XXXX-XXXX)

3. Configure Bleep

Launch Bleep and complete the initial setup:

• Sign in with your email (one-time code) or enter your license key directly
• Install the CA certificate (required for AI traffic inspection)
• Optionally customize proxy and PAC ports (defaults: 8080 and 18080)
• Bleep automatically configures selective routing - only AI services are monitored
• All other network traffic passes through completely untouched

4. Start protecting

Bleep runs in the system tray and protects AI interactions automatically. All data is stored locally in a SQLite database on your machine — nothing leaves your device.

• Close the window and it keeps protecting in the background
• Make a request to ChatGPT, Claude, Copilot, or any supported AI service
• Sensitive data is automatically detected, blocked, or redacted based on your policies
• View all detections in the dashboard in real-time

Test your setup

To verify Bleep is working, try sending a request with test sensitive data:

Bleep should detect and block (or redact) the API key pattern. Check your dashboard to see the detection.

You can also test file scanning: take a screenshot of a fake API key (e.g. sk-proj-test1234567890abcdef) and upload it as an image to any AI chat. Bleep will OCR the image and detect the key. This also works with PDFs, Office documents (DOCX, XLSX, PPTX), and text files — any file containing secrets will be detected.

MCP & AI agents: Bleep also protects traffic from MCP servers, Claude Desktop, Cursor, Windsurf, and other AI coding tools. Try pasting a test API key in any of these — Bleep will catch it the same way.