一个快速、键盘驱动的 HTTP 拦截代理,以及面向终端的黑客与渗透测试工具包。
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 更新(二进制安装自更新;Homebrew / Snap / AUR 提供包管理器指引)。
brew tap hahwul/gori
brew install gori
该仓库是一个 flake,因此无需安装即可运行:
nix run github:hahwul/gori
nix profile install github:hahwul/gori # 或保留它
需要 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 # 仅本次运行的全局绑定(不持久化)
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 可将项目交给不受信任的代理(仅读取工具,无实时请求)。
AI 设置指南介绍了如何连接代理并
运行你的第一个请求。
gori run(无头 CLI)gori run 在没有交互式 UI 的情况下暴露相同的核心项目和测试引擎。它
专为脚本和 CI 构建,但手动使用或从代理的 shell 中使用也同样适用:
gori run history --format json # 将捕获的流导出为 JSON
gori run sitemap # 目前看到的端点
gori run --help # 所有子命令
所有三个入口点共享同一个项目数据库。完整指南请参阅文档,或打开应用中的 Help 标签页。
shards build # 发布二进制文件位于 bin/gori
shards run gori # 无需安装即可运行
如果链接失败并出现未定义的 BrotliDecoder* 符号,说明 libbrotlidec 缺失或
pkg-config 找不到它 — 请参阅
安装指南了解系统库和
-Dwithout_native_codecs 离线构建。
欢迎贡献 — 请参阅 CONTRIBUTING.md 开始设置。
并非每种帮助都会以提交的形式出现,因此每个名字下方的文字说明了它是什么:上面的错误
报告和复现发现了 gori 自己无法发现的问题。要感谢某人,请编辑
.github/contributor-mural.yml。
gori(고리)是韩语中 环、链接或循环 的意思 — 这正是该工具所处的位置:在 你的客户端与其目标之间的循环中,捕获并重塑每个经过的请求。 坐镇循环之中。