gori v0.1.1

Hack from the terminal.

Installation • Usage • Documentation • Contributing

gori (고리 — Korean for ring, link, loop) sits in the loop between your client and its target, capturing every request and response as a flow you can intercept, replay, fuzz, and scan across HTTP/1.1, HTTP/2, WebSocket, gRPC, and SSE. Every action is also a gori run subcommand and an MCP tool, so scripts and AI agents can drive the same engagement.

Installation

Quick install (macOS / Linux)

curl -fsSL https://gori.hahwul.com/install.sh | bash

Then update later with gori update (self-update for binary installs; package-manager guidance for Homebrew / Snap / AUR).

Homebrew

brew tap hahwul/gori
brew install gori

From source

Requires Crystal >= 1.20.2 and pkg-config.

git clone https://github.com/hahwul/gori.git
cd gori
shards build --release

The binary is written to bin/gori.

For system libraries (Brotli / Zstd), offline builds, and other options, see the Installation guide.

Usage

gori runs one engine and one project behind three entry points. Drive it yourself, hand it to an AI agent, or script it, and pick the one that fits who is at the controls.

For humans: gori (TUI)

Start the proxy and open the interactive terminal UI. No subcommand needed:

gori

The proxy listens on 127.0.0.1:8070 by default, and a short first-run wizard picks the global default bind and theme (projects can pin their own later). To intercept HTTPS, trust gori's root CA. The quickest path is the palette's Open browser (Ctrl-P), which launches a browser already trusted and proxied. Captured traffic lands in History; press Ctrl-P for the command palette or Space for context actions.

gori --listen 0.0.0.0 --port 8080   # global bind for this run only (not persisted)

For AI agents: gori mcp (MCP server)

gori mcp is a Model Context Protocol server. An AI client spawns it over stdio, reads your traffic, and drives the same tools you do. Let gori write the config for your agent, then restart the client:

gori mcp --install-claude-code   # Claude Code   (~/.claude.json)
gori mcp --install-claude        # Claude Desktop
gori mcp --install-codex         # OpenAI Codex
gori mcp --install-agy           # Antigravity CLI
gori mcp --install-grok          # Grok

Add --read-only to hand a project to an untrusted agent (read tools only, no live requests). The AI Setup guide walks through connecting an agent and running your first request.

For scripts: gori run (headless CLI)

gori run mirrors every TUI action for non-interactive use. It is built for scripting and CI, but works just as well by hand or from an agent's shell:

gori run history --format json      # dump captured flows as JSON
gori run sitemap                    # endpoints seen so far
gori run --help                     # every subcommand

All three entry points share the same project database. See the documentation for the full guide, or open the Help tab in the app.

Development

shards build          # release binary at bin/gori
shards run gori       # run without installing

If linking fails with undefined BrotliDecoder* symbols, libbrotlidec is missing or pkg-config cannot find it — see the Installation guide for the system libraries and the -Dwithout_native_codecs offline build.

Contributing

1. Fork it (https://github.com/hahwul/gori/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Open a Pull Request

Contributors

• hahwul — creator and maintainer

Why "gori"?

gori (고리) is the Korean word for a ring, link, or loop — exactly where the tool sits: in the loop between your client and its target, capturing and reshaping each request as it passes through. Sit in the loop.