开发工具

Resterm:把 API 请求变成可进 Git 的纯文本,终端里的 HTTP/GraphQL/gRPC 客户端

unkn0wn-root 开源的 Go 终端 API 客户端:.http 纯文本可 diff 可 review,五协议,CI runner,Apache-2.0

项目资料

GitHub Ecosystem
仓库地址github.com/unkn0wn-root/resterm
许可证
Apache-2.0
主语言
Go
星标
2,010
核查时间
2026-11-07

以上快照资料以核查当日为准,可能随版本或运营策略变化。

Postman 式 API 客户端的问题在集合格式:请求存在私有 JSON 里,diff 不了、review 不了、换工具就锁死。unkn0wn-root 开源的 Resterm(Apache-2.0,Go 编写,截至 2026-11-07 有 2,010 星)把请求变回纯文本:API 写成 .http/.rest 文件——能 diff、能进 Git、能 code review,然后在一个键盘驱动的 TUI 里发送、看响应。HTTP、GraphQL、gRPC、WebSocket、SSE 五种协议一个客户端全覆盖;本地优先,无账号、无遥测。

核心功能

  • 请求即文件:.http/.rest 纯文本格式,编辑器里就能写,版本控制零成本——环境变量、密钥引用、响应捕获都写在同一文件里。
  • 五协议统一:HTTP、GraphQL、gRPC、WebSocket、SSE 在同一 TUI 里收发。
  • 脚本化测试与工作流:断言、多请求编排、mock、请求录制——从手工调试到回归测试一条线。
  • CI runner:配套 resterm-runner 无头 CLI,把同一批 .http 文件直接搬进流水线做接口回归。
  • 本地优先:无账号、无遥测;写请求有指令补全,发完即看响应,SSH 场景也覆盖。

典型使用场景

  • API 调试与 review:请求文件跟代码同仓提交,PR 里直接review接口变更。
  • 接口回归测试:.http 文件当测试用例,CI 里 resterm-runner 跑断言。
  • 离线/受限环境:无账号依赖,内网也能用全功能。

快速上手

从 GitHub Releases 下载二进制或按仓库 Makefile 构建;建一个 requests.http 写下第一个请求,TUI 里回车即发;CI 用法见 resterm-runner 子项目,断言失败会标出具体差异,回归结果直接可读。

小结

一句话定位:把「发请求」从图形工具的会话里搬回文本文件,Resterm 是这条路线目前完成度最高的实现,适合「请求要进 Git」为信条的团队与终端重度用户;要图形化协作、自动生成文档的团队仍会选 Postman/Insomnia 系。要点与边界:Apache-2.0、Go、2025-09 建库至今 2,010 星;gRPC/GraphQL 的支持深度以各自文档章节为准,.http 文件从 Bruno/VS Code REST Client 迁入基本零改写。它与 VS Code 的 REST Client 插件共享 .http 格式生态,但把执行搬进了独立 TUI——对 Vim/Neovim 用户是顺手的归宿,键盘流完全一致;配上 resterm-runner,同一批请求文件在本地调试与 CI 回归之间无缝流转,省掉的正是「接口文档与测试用例两套维护」的老账——请求定义即测试定义,改接口时只改一处。

站内写过的 BISHENG 管企业 Agent 平台层,若你的 Agent 需要调用外部 API,请求定义走 Resterm 的纯文本路线也便于 Agent 直接读写。