https://github.com/lucaspiritogit/treq
A Go-based terminal app for performing HTTP operations with an embedded sqlite to store your requests.
https://github.com/lucaspiritogit/treq
cli go golang http linux opensource requests sqlite terminal treq tview windows
Last synced: about 1 month ago
JSON representation
A Go-based terminal app for performing HTTP operations with an embedded sqlite to store your requests.
- Host: GitHub
- URL: https://github.com/lucaspiritogit/treq
- Owner: lucaspiritogit
- License: other
- Created: 2024-11-16T19:31:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-02T01:23:41.000Z (over 1 year ago)
- Last Synced: 2025-01-28T17:22:03.126Z (about 1 year ago)
- Topics: cli, go, golang, http, linux, opensource, requests, sqlite, terminal, treq, tview, windows
- Language: Go
- Homepage:
- Size: 89.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```bash
bun install
bun run dev
```
## Install
```bash
curl -fsSLO https://github.com/lucaspiritogit/treq/releases/latest/download/install.sh
sh install.sh
```
Install a specific version:
```bash
TREQ_VERSION=v0.1.0 sh install.sh
```
Windows (PowerShell):
```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