Skip to content
Back to search

gori

A fast, keyboard-driven HTTP intercepting proxy and hacking & pentesting toolkit for the terminal.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hahwul/gori with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hahwul/gori'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hahwul--gori/badge.svg)](/listings/hahwul--gori)

HTML

<a href="/listings/hahwul--gori"><img src="/api/listings/hahwul--gori/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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 Chocolatey / Homebrew / Snap / AUR).

On Windows, download `gori-windows-x86_64.exe` from [Releases](https://github.com/hahwul/gori/releases/latest), rename it to `gori.exe` and put it on your `PATH`.

Chocolatey

Starting with v0.8.0 (once the first version clears Chocolatey's moderation), install the Windows x86_64 package with:

choco install gori

Homebrew

brew tap hahwul/gori
brew install gori

Nix

The repo is a flake, so it runs without being installed:

nix run github:hahwul/gori
nix profile install github:hahwul/gori   # or keep it

From source

Requires [Crystal](https://crystal-lang.org/) `>= 1.21.0` 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](https://gori.hahwul.com/getting-started/installation/).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 198 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <br>
  3. <img src="docs/static/images/gori-wallpaper.webp">
  4. <p>A fast, keyboard-driven HTTP intercepting proxy and pentesting toolkit for the terminal,<br>built for humans and AI agents.</p>
  5. </div>
  6. <p align="center">
  7. <a href="https://github.com/hahwul/gori/blob/main/.github/CONTRIBUTING.md">
  8. <img src="https://img.shields.io/badge/CONTRIBUTIONS-WELCOME-000000?style=for-the-badge&labelColor=black"></a>
  9. <a href="https://github.com/hahwul/gori/releases">
  10. <img src="https://img.shields.io/github/v/release/hahwul/gori?style=for-the-badge&color=black&labelColor=black&logo=web"></a>
  11. <a href="https://crystal-lang.org">
  12. <img src="https://img.shields.io/badge/Crystal-000000?style=for-the-badge&logo=crystal&logoColor=white"></a>
  13. </p>
  14. <p align="center">
  15. <a href="#installation">Installation</a> •
  16. <a href="#usage">Usage</a> •
  17. <a href="docs/">Documentation</a> •
  18. <a href=".github/CONTRIBUTING.md">Contributing</a>
  19. </p>
  20. ---
  21. **gori** (고리, Korean for *ring, link, loop*) sits in the loop between your client and its target.
  22. It captures every request and response as a *flow* you can replay, fuzz, and scan across HTTP/1.1,
  23. HTTP/2, WebSocket, gRPC, and SSE, and holds HTTP/1.1 and HTTP/2 traffic for editing in flight.
  24. The TUI, `gori run`, and MCP share one engine and one project, so scripts and AI agents can drive
  25. the same engagement. The [capability matrix](https://gori.hahwul.com/reference/capabilities/)
  26. lists what each protocol and surface supports.
  27. ![gori TUI: the History tab listing captured HTTP flows](docs/static/images/tui/readme.svg)
  28. <details>
  29. <summary><strong>Features</strong></summary>
  30. ### Capture & Intercept
  31. - Capturing proxy for HTTP/1.1, HTTP/2, WebSocket, gRPC, and SSE
  32. - Intercept on HTTP/1.1 and HTTP/2, gRPC included: hold, edit, forward, or drop in flight. WebSocket messages too, with `proto:ws`
  33. - Searchable History with a query language
  34. - Scope rules, hostname overrides, and match & replace
  35. ### Replay, Fuzz & Decode
  36. - Repeater for crafting and re-sending requests, including WebSocket and gRPC
  37. - Fuzzer with four attack modes
  38. - Decoder for chained encode / decode / hash, including signed session cookies
  39. - Comparer for diffing two flows
  40. - Inline JWT / SAML / GraphQL / protobuf / MessagePack / CBOR decoding, hex view, and pretty-printing
  41. - Copy a request as cURL, Python, `fetch`, Go, httpie, or a CSRF PoC
  42. ### Discover & Scan
  43. - Probe: a passive and light-touch active vulnerability scanner
  44. - Param Miner for hidden parameters
  45. - Authorize: replay one request under several identities to find broken access control
  46. - Sequencer for grading the randomness of session, CSRF, and reset tokens
  47. - Cookie workbench to verify, crack, and re-sign Flask / Rack / Django session cookies
  48. - OAST collector for blind SSRF, XXE, and injection
  49. - Findings triage with Markdown / JSON / SARIF export
  50. ### Keyboard-first Workflow
  51. - Command palette (`Ctrl-P`) and space menu (`Space`) reach every action
  52. - Rebindable hotkeys and colour themes
  53. - Mouse support, multi-line editing, and go-to-line
  54. ### Headless & Scriptable
  55. - `gori run` for scripts and CI
  56. - `gori mcp`, an MCP server for AI agents (it does not start a capture proxy)
  57. </details>
  58. ## Installation
  59. ### Quick install (macOS / Linux)
  60. ```bash
  61. curl -fsSL https://gori.hahwul.com/install.sh | bash
  62. ```
  63. Update with `gori update`. On a Chocolatey, Homebrew, Snap, or AUR install it prints the package manager's command.
  64. On Windows, use [Chocolatey](#chocolatey), or download `gori-windows-x86_64.exe` from [Releases](https://github.com/hahwul/gori/releases/latest), rename it to `gori.exe`, and put it on your `PATH`.
  65. ### Chocolatey
  66. The [Chocolatey package](https://community.chocolatey.org/packages/gori) installs the Windows x86_64 binary:
  67. ```powershell
  68. choco install gori
  69. ```
  70. ### Homebrew
  71. ```bash
  72. brew tap hahwul/gori
  73. brew install gori
  74. ```
  75. ### Nix
  76. ```bash
  77. nix run github:hahwul/gori # run without installing
  78. nix profile install github:hahwul/gori # install
  79. ```
  80. ### From source
  81. Requires [Crystal](https://crystal-lang.org/) `>= 1.21.0` and `pkg-config`.
  82. ```bash
  83. git clone https://github.com/hahwul/gori.git
  84. cd gori
  85. shards build --release # writes bin/gori
  86. ```
  87. > System libraries (Brotli / Zstd), offline builds, and other options are in the
  88. > [Installation guide](https://gori.hahwul.com/getting-started/installation/).
  89. ## Usage
  90. One engine and one project, three entry points.
  91. ![One engine, three ways in: you through the TUI, your AI agent through gori mcp, your scripts through gori run](docs/static/images/gori-in-the-loop.webp)
  92. ### For humans: `gori` (TUI)
  93. ```bash
  94. gori
  95. ```
  96. The proxy listens on `127.0.0.1:8070`. A short first-run wizard picks the theme, and a new
  97. **global default** bind if that port is taken (projects can pin their own later). To intercept
  98. HTTPS, trust gori's root CA: **Open browser** in the palette (`Ctrl-P`) launches a browser that
  99. already trusts it and is proxied. Captured traffic lands in **History**. `Ctrl-P` opens the
  100. command palette and `Space` the context actions.
  101. ```bash
  102. gori --listen 0.0.0.0 --port 8080 # global bind for this run only (not persisted)
  103. ```
  104. ### For AI agents: `gori mcp` (MCP server)
  105. `gori mcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server. An AI client
  106. spawns it over stdio, reads your traffic, and uses the tools you do. Write the config for your
  107. agent, then restart the client:
  108. ```bash
  109. gori mcp --install-claude-code # Claude Code (~/.claude.json)
  110. gori mcp --install-claude # Claude Desktop
  111. gori mcp --install-codex # OpenAI Codex
  112. gori mcp --install-agy # Antigravity CLI
  113. gori mcp --install-grok # Grok
  114. gori mcp --install-hermes # Hermes (~/.hermes/config.yaml)
  115. gori mcp --install-pi # Pi (~/.pi/agent/mcp.json)
  116. ```
  117. Pi needs an MCP adapter, such as [pi-mcp-adapter](https://github.com/nicobailon/pi-mcp-adapter)
  118. (`pi install npm:pi-mcp-adapter`). The installer honors `PI_CODING_AGENT_DIR` when set.
  119. Add `--read-only` for an untrusted agent: read tools only, no live requests. The
  120. [AI Setup guide](https://gori.hahwul.com/getting-started/ai-setup/) covers connecting an agent and
  121. running a first request.
  122. ### For scripts: `gori run` (headless CLI)
  123. `gori run` runs the same engines without the UI, for scripts, CI, or an agent's shell:
  124. ```bash
  125. gori run history --format json # dump captured flows as JSON
  126. gori run sitemap # endpoints seen so far
  127. gori run --help # every subcommand
  128. ```
  129. All three share one project database. The full guide is in the
  130. [documentation](https://gori.hahwul.com) and in the app's **Help** tab.
  131. ## Development
  132. ```bash
  133. shards build # debug binary at bin/gori (add --release to optimise)
  134. shards run gori # run without installing
  135. ```
  136. If linking fails with undefined `BrotliDecoder*` symbols, `libbrotlidec` is missing or
  137. `pkg-config` cannot find it. The
  138. [Installation guide](https://gori.hahwul.com/getting-started/installation/) covers the system
  139. libraries and the `-Dwithout_native_codecs` offline build.
  140. ## Contributors
  141. [![The people who built gori, with what each of them contributed](docs/static/CONTRIBUTORS.svg)](https://github.com/hahwul/gori/graphs/contributors)
  142. Contributions are welcome. See [CONTRIBUTING.md](.github/CONTRIBUTING.md) to get set up. The line
  143. under each name says what the contribution was, because bug reports and reproductions count too.
  144. To credit someone, edit [`.github/contributor-mural.yml`](.github/contributor-mural.yml).
  145. ## Why "gori"?
  146. gori (고리) is Korean for **ring, link, or loop**, which is where the tool sits: in the loop
  147. between your client and its target. *Sit in the loop.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.