# HTTPeep Docs

- [Introduction](/introduction): HTTPeep is a cross-platform HTTP/HTTPS debugging proxy built with Rust. Learn what it does, who it's for
- Get Started
  - [Installation](/get-started/installation): Download HTTPeep for your platform, install the root CA certificate for HTTPS interception, and verify the installation with httpeep-cli.
  - [Capture Request in Chrome](/get-started/capture-chrome): Verify proxy setup, capture HTTPS traffic, and inspect sessions in HTTPeep using Chrome.
  - [Capture Requests in Terminal](/get-started/capture-terminal): Verify CLI/script traffic is flowing through HTTPeep using environment variables and curl.
  - [Create your first Rule](/get-started/first-rule): Get HTTPeep running in under one minutes: start the proxy, capture a real request, create a map-local inline-content rule, and verify it works.
- Rule Engine
  - [Capture and inspect HTTP/HTTPS](/rule-engine/traffic-capture): HTTPeep captures HTTP/1.1, HTTP/2, and HTTPS traffic in real time. Filter by domain, method, status, and path. Export sessions as JSON, HAR, or PCAP.
  - [Rule Engine](/rule-engine/rule-engine-arch): HTTPeep's composable rule engine matches traffic by domain, path, headers, and more, then routes it through a deterministic action pipeline.
  - [Mock APIs](/rule-engine/mock-map-local): Serve local files as API responses instead of hitting the real server. Supports JSON, JS, and any static content, with instant hot reload on file changes.
  - [Map Remote](/rule-engine/map-remote): Redirect matched requests to a different host without changing your code or modifying the system hosts file. Switch targets instantly.
  - [Breakpoint Debugging](/rule-engine/breakpoint-debugging): Breakpoint Debugging for HTTP Traffic, Pause requests and responses mid-flight to inspect and edit headers, body, and status code in real time. Pass the modified message or abort the connection.
  - [Network Throttling](/rule-engine/network-throttling): Network Throttling and Failure Simulation, Simulate slow networks, bandwidth limits, random failures, and disconnects to test how your app behaves under real-world network conditions.
  - [DNS Override](/rule-engine/dns-override): DNS Override Without Editing /etc/hosts ,Override DNS resolution per domain inside HTTPeep without touching the system hosts file. Supports wildcards and environment groups.
- CLI
  - [CLI Overview](/cli/overview): Understand what httpeep-cli can do and jump to command-specific guides.
  - [httpeep-cli: command-line interface overview](/cli/basics): httpeep-cli gives full programmatic access to the HTTPeep proxy engine — capture traffic, query sessions, manage rules, and replay requests from a terminal.
  - [Proxy](/cli/proxy): Control the HTTPeep proxy lifecycle from the terminal: start, pause, resume, stop, restart, and inspect the proxy engine.
  - [Sessions](/cli/sessions): Query and inspect captured traffic. List, filter, watch, and delete captured HTTP sessions from the command line. Combine with jq for powerful scripting and CI traffic analysis.
  - [DNS](/cli/dns): Manage HTTPeep DNS Override from the command line: global host mappings, environment groups, active environments, JSON/YAML import, and machine-readable output.
  - [Shell](/cli/shell): Enter an interactive terminal session with HTTPeep capture enabled using httpeep-cli shell or hp shell.
  - [License](/cli/license): Activate an HTTPeep license from the CLI and inspect the current license runtime status.
  - [Launch](/cli/launch): Launch browsers, terminals, Electron apps, and desktop applications with HTTPeep proxy capture enabled.
  - [Rules](/cli/rules): Create, update, test, import, export, and temporarily apply HTTPeep traffic manipulation rules from the command line.
  - [Request](/cli/request): Send HTTP requests through the HTTPeep proxy from the command line. Supports headers, body, proxy settings, HTTP version selection, and temporary rules.
  - [Replay](/cli/replay): Replay captured HTTP sessions from the command line. Replay by session ID with retry, replay from a script file, or replay the most recently captured request.
  - [Record](/cli/record): Record HTTP traffic flows into reusable script files for later replay or regression testing.
  - [Certificate](/cli/cert): Manage the HTTPS interception root CA certificate: install to the system trust store, check status, or export for manual installation.
  - [Import](/cli/import): Import traffic data from external formats into HTTPeep: cURL commands, HAR files, and raw HTTP messages.
  - [Monitor](/cli/monitor): Watch live HTTP traffic in a real-time terminal dashboard.
- SKILLS
  - [HTTPeep CLI Skill for AI Agents](/skills/httpeep-cli): Install the HTTPeep CLI Skill so AI coding agents can inspect real HTTP traffic, debug API failures, and close the loop between code changes and network evidence.
- AI & MCP
  - [MCP Overview](/mcp/overview): AI & MCP: give your AI agent network control, HTTPeep's built-in MCP server lets AI agents read live traffic, modify forward rules, manage DNS, and control the proxy — not just observe it.
  - [MCP Setup](/mcp/setup): Set up AI agent integration with HTTPeep MCP, Step-by-step setup for Codex, Claude Code, Kimi, and OpenCode — including config files, CLI commands, and how to fix common PATH issues.
- [Troubleshooting](/troubleshooting): Common issues and recovery paths for certificates, proxy setup, CLI, and MCP integration.

# HTTPeep Docs

- [Introduction](/zh-CN/introduction): HTTPeep is a cross-platform HTTP/HTTPS debugging proxy built with Rust. Learn what it does, who it's for
- Get Started
  - [Installation](/zh-CN/get-started/installation): Download HTTPeep for your platform, install the root CA certificate for HTTPS interception, and verify the installation with httpeep-cli.
  - [Capture Request in Chrome](/zh-CN/get-started/capture-chrome): Verify proxy setup, capture HTTPS traffic, and inspect sessions in HTTPeep using Chrome.
  - [Capture Requests in Terminal](/zh-CN/get-started/capture-terminal): Verify CLI/script traffic is flowing through HTTPeep using environment variables and curl.
  - [Create your first Rule](/zh-CN/get-started/first-rule): Get HTTPeep running in under one minutes: start the proxy, capture a real request, create a map-local inline-content rule, and verify it works.
- Rule Engine
  - [Capture and inspect HTTP/HTTPS](/zh-CN/rule-engine/traffic-capture): HTTPeep captures HTTP/1.1, HTTP/2, and HTTPS traffic in real time. Filter by domain, method, status, and path. Export sessions as JSON, HAR, or PCAP.
  - [Rule Engine](/zh-CN/rule-engine/rule-engine-arch): HTTPeep's composable rule engine matches traffic by domain, path, headers, and more, then routes it through a deterministic action pipeline.
  - [Mock APIs](/zh-CN/rule-engine/mock-map-local): Serve local files as API responses instead of hitting the real server. Supports JSON, JS, and any static content, with instant hot reload on file changes.
  - [Map Remote](/zh-CN/rule-engine/map-remote): Redirect matched requests to a different host without changing your code or modifying the system hosts file. Switch targets instantly.
  - [Breakpoint Debugging](/zh-CN/rule-engine/breakpoint-debugging): Breakpoint Debugging for HTTP Traffic, Pause requests and responses mid-flight to inspect and edit headers, body, and status code in real time. Pass the modified message or abort the connection.
  - [Network Throttling](/zh-CN/rule-engine/network-throttling): Network Throttling and Failure Simulation, Simulate slow networks, bandwidth limits, random failures, and disconnects to test how your app behaves under real-world network conditions.
  - [DNS Override](/zh-CN/rule-engine/dns-override): DNS Override Without Editing /etc/hosts ,Override DNS resolution per domain inside HTTPeep without touching the system hosts file. Supports wildcards and environment groups.
- CLI
  - [CLI Overview](/zh-CN/cli/overview): Understand what httpeep-cli can do and jump to command-specific guides.
  - [httpeep-cli: command-line interface overview](/zh-CN/cli/basics): httpeep-cli gives full programmatic access to the HTTPeep proxy engine — capture traffic, query sessions, manage rules, and replay requests from a terminal.
  - [Proxy](/zh-CN/cli/proxy): Control the HTTPeep proxy lifecycle from the terminal: start, pause, resume, stop, restart, and inspect the proxy engine.
  - [Sessions](/zh-CN/cli/sessions): Query and inspect captured traffic. List, filter, watch, and delete captured HTTP sessions from the command line. Combine with jq for powerful scripting and CI traffic analysis.
  - [DNS](/zh-CN/cli/dns): Manage HTTPeep DNS Override from the command line: global host mappings, environment groups, active environments, JSON/YAML import, and machine-readable output.
  - [Shell](/zh-CN/cli/shell): Enter an interactive terminal session with HTTPeep capture enabled using httpeep-cli shell or hp shell.
  - [License](/zh-CN/cli/license): Activate an HTTPeep license from the CLI and inspect the current license runtime status.
  - [Launch](/zh-CN/cli/launch): Launch browsers, terminals, Electron apps, and desktop applications with HTTPeep proxy capture enabled.
  - [Rules](/zh-CN/cli/rules): Create, update, test, import, export, and temporarily apply HTTPeep traffic manipulation rules from the command line.
  - [Request](/zh-CN/cli/request): Send HTTP requests through the HTTPeep proxy from the command line. Supports headers, body, proxy settings, HTTP version selection, and temporary rules.
  - [Replay](/zh-CN/cli/replay): Replay captured HTTP sessions from the command line. Replay by session ID with retry, replay from a script file, or replay the most recently captured request.
  - [Record](/zh-CN/cli/record): Record HTTP traffic flows into reusable script files for later replay or regression testing.
  - [Certificate](/zh-CN/cli/cert): Manage the HTTPS interception root CA certificate: install to the system trust store, check status, or export for manual installation.
  - [Import](/zh-CN/cli/import): Import traffic data from external formats into HTTPeep: cURL commands, HAR files, and raw HTTP messages.
  - [Monitor](/zh-CN/cli/monitor): Watch live HTTP traffic in a real-time terminal dashboard.
- SKILLS
  - [HTTPeep CLI Skill for AI Agents](/zh-CN/skills/httpeep-cli): Install the HTTPeep CLI Skill so AI coding agents can inspect real HTTP traffic, debug API failures, and close the loop between code changes and network evidence.
- AI & MCP
  - [MCP Overview](/zh-CN/mcp/overview): AI & MCP: give your AI agent network control, HTTPeep's built-in MCP server lets AI agents read live traffic, modify forward rules, manage DNS, and control the proxy — not just observe it.
  - [MCP Setup](/zh-CN/mcp/setup): Set up AI agent integration with HTTPeep MCP, Step-by-step setup for Codex, Claude Code, Kimi, and OpenCode — including config files, CLI commands, and how to fix common PATH issues.
- [Troubleshooting](/zh-CN/troubleshooting): Common issues and recovery paths for certificates, proxy setup, CLI, and MCP integration.