Documentation

Master the interactive HTTP shell. Learn how to install, configure your environment, and execute requests efficiently.

Getting Started

1. Install reqsh

Head over to the installation guide to download the binary or build from source.

2. Start the shell

Simply type reqsh in your terminal. This drops you into the interactive REPL.

reqsh

3. Set a base URL

Define your target host. All subsequent requests in this session will be appended to this base URL automatically.

reqsh> base https://api.example.com

4. Send a request

Type the HTTP method and the relative path. Then execute it using the special ::send command.

reqsh> GET /users

.....> ::send

Sending Requests

The shell supports building complex requests step-by-step. Start with the method and path. Add headers on the following lines. Leave a blank line to start writing the JSON body.

reqsh> POST /users

.....> Content-Type: application/json

.....>

.....> {"name": "Alice", "email": "alice@example.com"}

.....> ::send

Variables

Store values with set and reference them anywhere in your request using {{name}}. Variables are interpolated at request time.

reqsh> set token eyJhbGciOiJIUzI1NiJ9

reqsh> set host api.example.com

reqsh> GET /users/{{token}}

.....> Authorization: Bearer {{token}}

.....> ::send

Query Parameters

Add query parameters with param: lines. Values are URL-encoded automatically.

reqsh> GET /users

.....> param: page=1

.....> param: limit=20

.....> ::send

Save & Run

Save a request to session memory after executing it, then run it again instantly without retyping.

reqsh> GET /users/{{id}}

.....> ::send

reqsh> save get-user

saved

reqsh> run get-user

Built-in Commands

Beyond standard HTTP methods (GET, POST, PUT, DELETE), reqsh provides specific REPL commands to manage your session.

Command	Usage	Description
base	base <url>	Set the global base URL for the session.
header	header <key> <value>	Add a persistent header applied to all requests.
set	set <name> <value>	Store a variable for interpolation.
unset	unset <name>	Remove a variable.
unset header	unset header <key>	Remove a global header.
save	save <name>	Save the last executed request to memory.
run	run <name>	Execute a saved request.
vars	vars	List all session variables.
headers	headers	List all global headers.
requests	requests	List all saved requests.
history	history	View the numbered history of past commands.
rerun	rerun <id>	Instantly re-execute a request from history.
help	help	Display syntax and command documentation.
exit	exit	Terminate the shell session.