treq 🦖

treq is a keyboard-first HTTP client for the terminal, built with OpenTUI. It is designed around a vim-like workflow so you can move between URL, headers, request body, response, saved requests, and commands without touching the mouse.

Run locally

bun install
bun run dev

Install

curl -fsSLO https://github.com/lucaspiritogit/treq/releases/latest/download/install.sh
sh install.sh

Install a specific version:

TREQ_VERSION=v0.1.0 sh install.sh

Windows (PowerShell):

iwr https://github.com/lucaspiritogit/treq/releases/latest/download/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1

Features

• Vim-style command mode (:) with command suggestions (for example :send, :save, :list, :help)
• Fast keyboard-driven flow for method, URL, headers, request body, and response body
• Request list sidebar (toggleable), with keyboard navigation
• Save requests locally to your user config directory (~/.config/treq/treq-requests.json on Unix)

Keyboard Shortcuts

• : open command mode
• Esc switch to interactive mode and interactive method
• Tab / Shift+Tab cycle focus between panels
• Ctrl+Enter / Cmd+Enter / Alt+Enter send request
• Enter send request (interactive mode, non-request-list focus)
• i focus URL input
• h focus headers input
• r focus request body input
• b focus response body panel
• l / Left focus request list (opens list if hidden)
• g set method GET
• p set method POST
• u set method PUT
• t set method PATCH
• d set method DELETE
• Request list: Up/Down or k/j navigate, Enter load selected request, Ctrl+d / Cmd+d delete selected request

Commands

• :send, :s, :run send current request
• :save save current request (overwrites loaded request)
• :list focus request list sidebar
• :toggle-list, :tl, :sidebar toggle request list sidebar
• :reload, :load reload requests from treq-requests.json
• :url, :i, :input focus URL input
• :headers, :h focus headers input
• :request, :req, :r focus request body input
• :response, :res, :body, :b focus response body
• :get, :g set method GET
• :post, :p set method POST
• :put, :u set method PUT
• :patch, :t set method PATCH
• :delete, :d set method DELETE
• :debug, :dbg open debug modal to see additional context about the request and the response.
• :help open command help modal
• :quit, :q, :exit close app