Skip to content

A lightweight, terminal-based reverse proxy for simulating network latency and jitter. Built with Go and Bubble Tea.

Notifications You must be signed in to change notification settings

ellis3684/jitter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jitter Proxy

Jitter Demo

Jitter Proxy is a lightweight, terminal-based reverse proxy designed for frontend developers and QA engineers. It allows you to simulate network latency (jitter) on any existing API or website to test how your application handles slow connections.

License Go Version

Features

  • TUI Dashboard: Real-time request logging (Method, Status, Duration, Path).
  • Latency Injection: Toggle artificial delay on/off instantly.
  • Smart Configuration: Remembers your settings and latency state between restarts.
  • Cross-Platform: Works on macOS, Linux, and Windows.

Installation

From Source

  1. Ensure you have Go installed.
  2. Clone the repository:
    git clone https://github.com/ellis3684/jitter.git
    cd jitter
  3. Build the binary:
    make build

Usage

Start the proxy by pointing it at a target URL:

# Proxy traffic to Google
./build/jitter --target google.com

# Proxy to local API with a custom 2-second (2000ms) delay
./build/jitter --target localhost:3000 --port 8080 --latency 2000

Controls (TUI)

Key Action
L Toggle Latency ON/OFF
Q Quit the application

CLI Flags

Flag Default Description
--target https://www.google.com The upstream URL to proxy to.
--port 8080 The local port Jitter will listen on.
--latency 500 The added delay in milliseconds.

Configuration

Jitter automatically saves your settings to config.json on exit. You can also manually edit this file to set persistent defaults.

config.json

{
  "target": "https://www.google.com",
  "port": "8080",
  "latency_ms": 500,
  "latency_enabled": false
}

License

MIT

About

A lightweight, terminal-based reverse proxy for simulating network latency and jitter. Built with Go and Bubble Tea.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published