Proxy
Control the HTTPeep proxy lifecycle from the terminal: start, pause, resume, stop, restart, and inspect the proxy engine.
The proxy subcommand controls the HTTPeep proxy engine lifecycle. The capture alias is equivalent to proxy and is provided for users who think in terms of "capturing traffic" rather than "managing a proxy."
proxy start
Start the proxy server in the background.
httpeep-cli proxy start --port 8800| Flag | Description | Default |
|---|---|---|
--port <port> | Listen port for the proxy | — |
--capture-pid <pid> | Only capture traffic from the given process ID (repeatable) | — |
--watch | Start watching new sessions immediately after the proxy starts | — |
Capture traffic from specific processes only:
httpeep-cli proxy start --capture-pid 1234 --capture-pid 5678Start and immediately watch new traffic:
httpeep-cli proxy start --watchproxy pause
Pause traffic capture while keeping transparent forwarding active. Requests continue to flow through the proxy but are not stored as sessions.
httpeep-cli proxy pauseproxy resume
Resume traffic capture after a pause.
httpeep-cli proxy resumeproxy stop
Stop the proxy server completely.
httpeep-cli proxy stopproxy restart
Restart the proxy server. This is equivalent to stop followed by start.
httpeep-cli proxy restartproxy status
Get the current proxy status.
httpeep-cli proxy statusproxy info
Show detailed instance information, including the lock file path and uptime.
httpeep-cli proxy infoproxy logs
Show the log file location and tail recent logs.
# Show the last 50 lines
httpeep-cli proxy logs
# Show the last 100 lines
httpeep-cli proxy logs --lines 100
# Follow new log output
httpeep-cli proxy logs --follow| Flag | Description | Default |
|---|---|---|
--lines <n> | Number of lines to show | 50 |
--follow / -f | Follow log output continuously | — |
proxy system
Configure the system proxy settings so that all applications route traffic through HTTPeep automatically.
# Enable system proxy
httpeep-cli proxy system on
# Disable system proxy
httpeep-cli proxy system off
# Check system proxy status
httpeep-cli proxy system statuscapture alias
capture is a direct alias for proxy. All of the above commands work identically with capture:
httpeep-cli capture start --port 8800
httpeep-cli capture status
httpeep-cli capture pauseWhen the proxy is stopped, traffic no longer flows through HTTPeep. Existing captured sessions remain in the session store until you clear them.
httpeep-cli: command-line interface overview
httpeep-cli gives full programmatic access to the HTTPeep proxy engine — capture traffic, query sessions, manage rules, and replay requests from a terminal.
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.