Skip to content
BLAZLE
Start free
Back to docs

Installation Methods

In-Flight Terminal Proxy

The BLAZLE local proxy runs on your computer and checks what your AI tools send and run before it happens: prompts on their way to the model, code your editor saves, and shell commands an agent is about to run (like rm -rf, sudo or curl ... | sh). It also checks the model's answers before your agent acts on them. Think of it as a guard at the door between your computer and the AI: everything going out and coming back passes through it.

What it does for you

  • Asks before a command runs. Your agent asks the proxy before running a shell command. Commands that wipe folders, take admin rights or pipe a download into a shell are blocked. For Claude Code this is one hook, set up below.
  • Protects what you send. Passwords, keys and personal data in a prompt are masked, only where they appear; the rest of the conversation reaches the AI unchanged. Every message format your tools use is checked.
  • Catches tricks in any language.Prompts that pass the rules on your machine are also checked by BLAZLE's AI layer, which spots attempts to hijack the AI written in Vietnamese, Chinese, Thai and many other languages. Secrets are masked before this check. To keep every prompt on your machine (rules only), start the proxy with BLAZLE_CLOUD_AI=off.
  • Checks the answers coming back. If the model tells your agent to run a destructive command, the answer is stopped before the agent can act on it. Cloud keys and tokens in an answer are masked (answers that are not streamed).
  • Same rules everywhere.The proxy follows your workspace's Standard or Strict mode and your custom rules, synced automatically, so it decides exactly like BLAZLE in the cloud.
  • Clear records. Every block appears in Intercepts → IDE Proxy with the rule that caught it. Sensitive values are masked in the record.

Install in 1 second (Recommended)

The fastest, zero-friction way to install the BLAZLE proxy on macOS and Linux:

curl -fsSL https://blazle.io/install.sh | bash

Automatically detects Apple Silicon (M-series) or Intel, sets executable permissions, clears macOS Gatekeeper quarantine, and links blazle-proxy into your PATH.

Set-and-Forget Background Service

Want BLAZLE to run silently in the background 24/7 so you never have to start it manually each day? Pass your API key during installation:

BLAZLE_API_KEY="blz_live_..." curl -fsSL https://blazle.io/install.sh | bash

On macOS, this automatically configures a native LaunchAgent daemon that starts on login, restarts on failures, and uses ~0% CPU.

Manual Download

Or download the standalone binary directly:

Run it

Create an API key in the dashboard (API Keys), then start the proxy:

macOS / Linux

export BLAZLE_API_KEY="blz_live_..."
blazle-proxy

Windows (PowerShell)

$env:BLAZLE_API_KEY="blz_live_..."
.\blazle-proxy-windows-x64.exe

The proxy listens on http://127.0.0.1:8081, only on your machine. Point your tools at it (for example an OpenAI-compatible base URL of http://127.0.0.1:8081/v1), or install the VS Code extension, which uses it automatically. Requests that pass are forwarded to OpenAI; set OPENAI_UPSTREAM to use another OpenAI-compatible provider. Add --help to see all options.

Check commands before an agent runs them

With the proxy running, ask BLAZLE about a command. It answers in an instant: exit code 0 means allowed, 2 means blocked, with the reason printed.

blazle-proxy check "rm -rf ~/projects"
# BLAZLE blocked this command: Blocked potentially destructive recursive/forced 'rm' command.

Add it as a hook so your agent checks every shell command first. For Claude Code, put this in .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "blazle-proxy check" }
        ]
      }
    ]
  }
}

Any agent or script can do the same: call check with the command, or send {"command": "..."} to http://127.0.0.1:8081/intercept/command. If the proxy is not running, check blocks to stay safe and tells you how to start it.

Architecture

The proxy runs on top of the ultra-low latency BLAZIL Engine.

  • Decision first: the verdict is returned before any logging or storage happens, so recording never slows your agent down.
  • Sub-millisecond rules: most commands and payloads are decided in well under a millisecond on your machine. The AI check for prompts adds one short round trip to BLAZLE.
  • No noticeable delay: terminal commands are intercepted instantly while your agents run at full speed.