v0.8.9Use HTTPeep with Claude Code, Codex & Cursor
Currently in Beta

The Professional HTTP/HTTPSDebugger & Programmable Proxy forModern Developers.

A composable HTTP debugger to intercept, mock, and rewrite traffic — with a rule engine you configure once and reuse forever.

Other platforms:WindowsLinux
1

Proxy Settings & Rule Management

One-stop proxy and rule console. Configure system proxy, external proxy, Bypass, DNS Override, and rule orchestration.

ProxyRulesDNS OverrideBypass
2

Quick Filtering

Filter by domain, source app, status code, color, note, and more. Pinpoint requests in seconds.

DomainSource AppColorNote
3

Advanced Filtering

Filter by protocol, port, size, duration, and keyword. One-click status code filtering.

ProtocolPortSizeDuration
4

Status Bar

Real-time session hit policies and rule actions. Processing steps at a glance.

SessionPolicyAction
5

Request / Response Inspector

Inspect Request / Response details with JSON highlighting, Headers, and Timing breakdown.

JSONHeadersTiming
6

Command Palette

Press ⌘K for the Command Palette. Developer tools and shortcuts in one place.

⌘KShortcuts
Traffic Flow Architecture

Intercept, Modify, Route, Debug One Rule Handles It All

Visualize how every HTTP/HTTPS request flows through HTTPeep's composable rule engine — from capture to response delivery.

Your App / BrowserHTTPeepProxySSL DecryptionTraffic CaptureRule EngineBreakpoint DebuggingMock & MapAI · MCP · CLIBypass CheckPass through or continue processingbypass → transparentGlobal DNS OverrideGlobally override DNS resolutionGlobal External ProxyRoute via upstream proxyRule MatchingPattern matching engineResolve ActionPass ThroughMap RemoteMap LocalBlock↑ Click to select resolve actionRequest PipelineDNS OverrideExternal ProxyDelayThrottleModify RequestBreakpointTarget ServerResponse PipelineDelayThrottleModify ResponseBreakpointClient ResponseDeliver modified response
Request Flow
Response Flow
Decision Point
Local Override
Block

Full-Cycle HTTP Debugging Workbench

Capture traffic, intercept sessions, simulate network conditions, override DNS, mock APIs, and compose rule pipelines — all in a single local proxy.

Capture HTTP / HTTPS Traffic

HTTPHTTPSTLS
HTTPeepHTTPeep · Capture HTTP / HTTPS Traffic

HTTPeep proxies your app traffic locally and records every request and response — headers, body, query params, status codes, timing, and TLS session details.

Breakpoint Debugging

RequestResponseEdit
HTTPeepHTTPeep · Breakpoint Debugging

Pause any request or response mid-flight, edit headers, body, query, or status code inline, then choose to forward, abort, or pass through the rule chain.

Latency Injection & Throttling

DelayThrottlePacket Loss
HTTPeepHTTPeep · Latency Injection & Throttling

Inject fixed or variable delays, bandwidth limits, and packet loss per matching rule. Reproduce flaky endpoints and timeout behavior consistently, without external tools.

Zero-Intrusion DNS Override, No Side Effect

DNSLocalStaging
HTTPeepHTTPeep · Zero-Intrusion DNS Override, No Side Effect

Override DNS resolution at the proxy layer. No hosts file edits, no system config changes, no cache, no side effects — map any production domain to local or staging services cleanly.

API Mock with Full HTTPS Support

URL PatternMockHTTPS
HTTPeepHTTPeep · API Mock with Full HTTPS Support

Return custom responses for any URL pattern over HTTP or HTTPS. Decouple frontend development from backend availability and cover edge cases before integration.

NEW FEATURE

AI Skills. Debug Like You Chat.

Connect Claude Code to HTTPeep. Fetch flows, analyze requests, and create debugging rules — all from a single sentence in your terminal.

Claude Code · HTTPeep CLI SKILLS
Mock /api/user response and change subscription.tier from free to pro, help me test edge cases
Analyzing: User needs to override subscription.tier in /api/user responses. I will search for recent matching sessions, inspect the response structure, then create a modify_response rule.
Tool Callhttpeep_sessions_list
Arguments
{
  "url_like": "/api/user",
  "limit": 5,
  "status_code": 200
}
Result
Returned 3 matching sessions
CLI$ hp sessions list --url-like "/api/user" --limit 5
ID        METHOD  URL                      STATUS  DURATION
abc123    GET     /api/user                200     45ms
def456    GET     /api/user/profile        200     32ms
ghi789    POST    /api/user/update         200     120ms
Found 3 matching sessions. Inspecting the latest abc123 for response structure...
Tool Callhttpeep_session_detail
Arguments
{
  "session_id": "abc123",
  "unredacted": true
}
CLI$ hp sessions list --id abc123 --format json
{
  "response_body_preview": {
    "id": "u_123",
    "name": "Alice",
    "subscription": {
      "tier": "free",
      "expires_at": "2026-12-31"
    }
  }
}
Response structure confirmed. Now creating a modify_response rule to override subscription.tier from "free" to "pro":
Tool Callhttpeep_rules_upsert
Arguments
{
  "rule": {
    "id": "mock-user-tier-pro",
    "enabled": true,
    "match": {
      "domains": [{"type":"exact","value":"api.example.com"}],
      "paths": [{"type":"exact","value":"/api/user"}]
    },
    "actions": [{
      "type": "modify_response",
      "json_path": "$.subscription.tier",
      "replace_with": "pro"
    }]
  }
}
Result
Rule created, quota: { used: 2, limit: 10 }
CLI$ hp rules upsert --rule-file ./mock-tier-pro.json
✓ Rule "mock-user-tier-pro" upserted
  Quota: 2 / 10 used
  Builtin rules: 3
JSON Diffmodified
Before
{
  "id": "u_123",
  "name": "Alice",
  "subscription": {
    "tier": "free",
    "expires_at": "2026-12-31"
  }
}
After
{
  "id": "u_123",
  "name": "Alice",
  "subscription": {
    "tier": "pro",
    "expires_at": "2026-12-31"
  }
}
✓ Mock rule active · matching requests return modified response
Type a command to let AI help you debug...
Enter

HTTPeep's built-in AI Skills let assistants interact with your debugging session in real time — no plugins required.

Learn more

Works with Your Favorite AI Tools

Claude Code
ChatGPT
Gemini CLI
Codex CLI
Cursor
Rule as Code

Rule as Code

Debugging configuration is based on files, which can be saved, exported, and shared with teams. Rules become reusable debugging assets.

Configuration Structure
~/.httpeep/rules/
├── rule.yaml              # Rule Configuration
├── bypass.yaml            # Bypass Configuration
├── dns_override.yaml      # DNS Override Configuration
├── external_proxy.yaml    # External Proxy Configuration
└── rate_limit.yaml        # Rate Limit Configuration
rule.yaml
# rule.yaml - Main Rule Configuration Example
- id: rule_mnhi5xkt
  description: "Frontend Mock API"
  enabled: true
  builtin: false
  stopAfterMatched: false
  match:
    domains:
    - type: exact
      value: api.example.com
    originProtocol: https
  requestActions: []
  resolve:
    type: map_local_dir
    filePath: /Users/chris/mocks/api
    headers:
      x-httpeep-debug: '1'
  responseActions:
  - type: delay_response
    id: action_1775140499860
    enabled: true
    delayMs: 500
  - type: throttle_response
    id: action_1775591855867
    enabled: true
    speed:
      max: 384
      burst: 768

Separate Config Files

Manage each environment/project independently

Git Version Control

Track modification history

Team Synchronization

Share rule configurations

Import & Export

Quick migration and backup

Team Collaboration Workflow
1
Personal debugging rules saved in local Git repository
2
Team shared rules synced via Git remote repository
3
Different project branches for rule sets
4
Review rule changes through Pull Request (PR) process
DNS Override

Flexible Domain Resolution Management, Zero-Intrusion DNS Override

Multi-environment DNS Override Configuration management, say goodbye to frequent hosts file modifications

DNS Override
Fast switching between development environments (dev / staging / prod)
Local service mapping test (localhost → 127.0.0.1)
Intranet domain resolution management
Zero-intrusion DNS override, avoiding system side effects and hosts pollution
Support for wildcard domain resolution

Capture → Rule → Modify → Done

Capture → Rule → Modify → Done

Download and use, start capturing and debugging traffic in minutes

01
Capture

Install & Trust Certificate

Choose platform to install, one-click install Root CA to system trust, enable HTTPS decryption.

macOS 10.15+ · Windows 10+ · glibc 2.31+

02
Rule

Capture Traffic

Start the proxy, browser or system traffic automatically goes through HTTPeep, real-time list display.

Supports Chrome, Terminal, Docker, mobile devices

03
Modify

Configure Rules

Set up forwarding, Mock, and breakpoint rules; configure once for permanent effect, exportable for team sharing.

Map Local · Breakpoint · Delay · Reject

04
Done

Debug & Modify

Intercept target requests, modify data in real-time, observe application reaction after release, and locate issues.

Edit · Continue · Abort · Replay

Download HTTPeep

Free to download.