Getting Started

Get up and running with gg in three steps.

1. Install

Homebrew (macOS / Linux)

brew install shyam-s00/tap/gg

Manual download

Prebuilt binaries for macOS, Linux, and Windows are available on the GitHub Releases page.

2. Point it at any .http file

Create a simple api.http file (or use an existing one from your IDE):

GET http://localhost:8080/health
Accept: application/json

3. Run the simulation

Use a built-in profile to automatically shape the traffic (ramping up, sustaining, and cooling down):

gg --profile flash-sale --http-file api.http

You’ll drop straight into the interactive Chaos TUI, where you can monitor latencies and adjust load in real-time with the arrow keys.

---

Ready for more? Explore Load Profiles to tune RPS and duration, or dive into the TUI to learn the controls.