Conflux Lens
Open Source|MIT License

See Through the AI Black Box

A purpose-built HTTP proxy for AI agents. Inspect every request, response, token, and tool call — in real time.

terminal
$ git clone https://github.com/...
$ cd conflux-lens && npm install
$ npm start
Proxy: localhost:9876
Dashboard: localhost:3000
What Lens Does

Everything Your AI Agent Hides

AI agents send complex HTTP payloads you can't see. Conflux Lens exposes the full picture — from raw JSON to token counts.

System Prompt Visibility

See the exact system prompt being constructed and sent — not just the final response.

Real-Time Streaming

Watch streaming responses (SSE) render live as tokens arrive from the API.

Cost & Token Tracking

Track per-call and cumulative token usage with cost estimation per model.

Tool Call Visualization

See every tool call, function signature, and result in a structured tree view.

Multi-Step Loop Tracking

Follow agent reasoning chains across multi-turn conversations and tool loops.

Dashboard UI

Beautiful real-time dashboard with request feed, filters, and detailed inspectors.

Get Running in 60 Seconds

Quick Start Guide

From zero to seeing every AI API call in under a minute.

One-Line Install

No git clone, no npm install — just run one command and everything is set up automatically.

macOS / Linux
curl -fsSL https://lens.theconflux.com/install.sh | bash
Windows PowerShell
powershell -c "irm https://lens.theconflux.com/install.ps1 | iex"
Full Install (Manual)
01

Clone & Install

Get the project and install dependencies with npm.

clone-& install
02

Set Up HTTPS Trust

Generate and trust the CA certificate for HTTPS interception.

set-up https trust
npm run setup-trust setup
# Follow the printed instructions
# to configure NODE_EXTRA_CA_CERTS
03

Start the Proxy

Launch the proxy server and dashboard.

start-the proxy
npm start
# Shows:
# Proxy Server: localhost:9876
# Dashboard: localhost:3000
04

Configure Your Client

Point your AI agent or Node.js app to the proxy.

configure-your client
export HTTP_PROXY=http://localhost:9876
export HTTPS_PROXY=http://localhost:9876
export NODE_EXTRA_CA_CERTS="$HOME/.conflux-lens/ca.pem"
# Windows PowerShell:
$env:HTTP_PROXY="http://localhost:9876"
05

Open Dashboard

Watch your AI traffic in real-time.

open-dashboard
# macOS
open http://localhost:3000
# Windows
start http://localhost:3000
# Linux
xdg-open http://localhost:3000

Works on macOS, Linux, and Windows. Full platform-specific instructions in the docs.

For Developers

Powerful SDK

Programmatic control with a clean TypeScript API. Start the proxy, intercept requests, or stream events — all from code.

import { createProxyServer } from '@theconflux/lens-sdk';

const proxy = createProxyServer({
  port: 9876,
  host: '127.0.0.1',
  wsPort: 9877,
  logLevel: 'info',
  autoConfigureTrust: true,
});

await proxy.start();
console.log('Proxy running at http://127.0.0.1:9876');

const exchanges = proxy.getExchanges();
console.log(`Captured ${exchanges.length} exchanges`);

// Export to HAR
import * as fs from 'fs';
const har = proxy.exportHar();
fs.writeFileSync('capture.har', JSON.stringify(har, null, 2));

await proxy.stop();
npm install@theconflux/lens-sdk ws
Why Conflux Lens

Built for AI Agents

BurpSuite was built for web security. We built Lens for AI agent debugging.

Feature
Conflux Lens
BurpSuite Pro
Price
Free (MIT)
$449/year
HTTP Proxy
HTTPS Intercept
LLM Token Display
Cost Tracking
Tool Call View
System Prompt View
Streaming Support
No Browser Extension
Open Source