一个快速、键盘驱动的 HTTP 拦截代理,以及面向终端的黑客与渗透测试工具包。
从终端发起黑客攻击。
gori(고리 — 韩语意为环、链接、循环)位于你的客户端与其目标之间的循环之中,
将每个请求和响应捕获为一个流,你可以对其重放、模糊测试和扫描,覆盖 HTTP/1.1、
HTTP/2、WebSocket、gRPC 和 SSE,并在 HTTP/1.1 和 HTTP/2 上进行飞行中拦截。跨界面的核心评估
操作使用相同的引擎,这些工作流也可
通过 gori run 和 MCP 使用,因此脚本和 AI 代理可以驱动相同的评估工作。
能力矩阵明确列出了协议和
界面限制。
proto:ws 选择启用fetch、Go、httpie 或 CSRF PoCCtrl-P)和上下文空间菜单(Space)可触达每个操作gori run 为非交互式使用暴露核心项目和测试工作流gori mcp)将这些工作流暴露给 AI 代理(它不会启动捕获代理)curl -fsSL https://gori.hahwul.com/install.sh | bash
之后使用 gori update 进行更新(二进制安装可自更新;Chocolatey / Homebrew / Snap / AUR 请遵循包管理器指引)。
在 Windows 上,可使用 Chocolatey,或从 Releases 下载 gori-windows-x86_64.exe,将其重命名为 gori.exe 并放入你的 PATH。
Chocolatey 包会安装 Windows x86_64 二进制文件:
choco install gori
brew tap hahwul/gori
brew install gori
该仓库是一个 flake,因此无需安装即可运行:
nix run github:hahwul/gori
nix profile install github:hahwul/gori # or keep it
需要 Crystal >= 1.21.0 和 pkg-config。
git clone https://github.com/hahwul/gori.git
cd gori
shards build --release
二进制文件会写入 bin/gori。
关于系统库(Brotli / Zstd)、离线构建及其他选项,请参阅 安装指南。
gori 在三个入口点背后运行一个引擎和一个项目。你可以自己驱动它,交给 AI 代理,或编写脚本调用它,并选择适合当前操作者的方式。

gori(TUI)启动代理并打开交互式终端 UI。无需子命令:
gori
代理默认监听 127.0.0.1:8070,首次运行时会出现一个简短的向导,用于选择全局默认绑定和主题(项目之后可以固定自己的设置)。要拦截 HTTPS,需要信任 gori 的根 CA。最快捷的方式是使用命令面板中的 Open browser(Ctrl-P),它会启动一个已信任并已配置代理的浏览器。捕获的流量会进入 History;按 Ctrl-P 打开命令面板,或按 Space 打开上下文操作。
gori --listen 0.0.0.0 --port 8080 # global bind for this run only (not persisted)
gori mcp(MCP 服务器)gori mcp 是一个 Model Context Protocol 服务器。AI 客户端
通过 stdio 启动它,读取你的流量,并驱动与你相同的工具。让 gori 为你的代理编写
配置,然后重启客户端:
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
gori mcp --install-hermes # Hermes (~/.hermes/config.yaml)
gori mcp --install-pi # Pi (~/.pi/agent/mcp.json)
Pi 需要一个 MCP 适配器,例如 pi-mcp-adapter
(pi install npm:pi-mcp-adapter)。安装程序在设置了 PI_CODING_AGENT_DIR 时会遵循该变量。
添加 --read-only 可将项目交给不受信任的 agent(仅限读取工具,不发送实时请求)。
AI 设置指南 介绍了如何连接 agent 并
运行你的第一个请求。
gori run(无头 CLI)gori run 在没有交互式 UI 的情况下暴露相同的核心项目和测试引擎。它
专为脚本编写和 CI 而构建,但手动使用或从 agent 的 shell 中使用也同样适用:
gori run history --format json # dump captured flows as JSON
gori run sitemap # endpoints seen so far
gori run --help # every subcommand
所有三个入口点共享同一个项目数据库。完整指南请参阅文档,或打开应用中的 Help 标签页。
shards build # debug binary at bin/gori (add --release to optimise)
shards run gori # run without installing
如果链接失败并出现未定义的 BrotliDecoder* 符号,说明缺少 libbrotlidec,或者
pkg-config 找不到它——请参阅
安装指南 了解系统库以及
-Dwithout_native_codecs 离线构建方式。
欢迎贡献——请参阅 CONTRIBUTING.md 了解如何开始。
并非每一种帮助都会以提交的形式体现,因此每个名字下方的文字说明了具体贡献:上面列出的缺陷
报告和复现发现了 gori 自身无法发现的问题。要为某人署名,请编辑 .github/contributor-mural.yml。
gori(고리)在韩语中意为环、链接或循环——这正是该工具所处的位置:位于你的客户端与其目标之间的 循环之中,在每次请求经过时捕获并重塑它。 Sit in the loop.