peep

A TUI HTTP proxy for developers who want to see what's going on. Think Proxyman, but in your terminal.

Built with Ink and React.

Status: Under active development. Core proxy and TUI are functional.

Why

Debugging HTTP traffic shouldn't require leaving the terminal. Peep sits between your app and the internet, letting you inspect requests and responses in a clean terminal UI.

Features

• HTTP and HTTPS interception (automatic CA generation and trust)
• Three-panel TUI: domain sidebar, request list, request/response detail
• Request/response detail with headers, body, and raw views
• Syntax-highlighted body previews (JSON, HTML, CSS, XML)
• Domain grouping and filtering in the sidebar
• Sortable request list (by method, URL, status, duration, size)
• Vim-style keyboard navigation (hjkl, gg/G)
• Copy request/response to clipboard
• Automatic system proxy configuration (macOS)
• Firefox/Zen NSS certificate store support

Usage

peep              # start on default port 8080
peep --port=3128  # custom port

Peep will automatically configure itself as the system HTTP proxy and install its CA certificate on first run.

Keyboard Shortcuts

| Key | Action | |-----|--------| | j / k | Scroll up/down | | h / l | Switch panels / expand-collapse groups / switch tabs | | Enter | Select / drill into detail | | Esc | Go back | | s | Sort request list | | y | Copy to clipboard | | gg / G | Jump to top/bottom | | q | Quit |

Install

npm install --global peep-proxy

Development

pnpm install
pnpm dev       # watch mode
pnpm build     # compile
pnpm lint      # check linting
pnpm format    # check formatting

Tech Stack

• Runtime: Node.js
• UI: Ink v4 + React 18
• Language: TypeScript
• Tooling: Biome (lint + format), pnpm

License

MIT