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

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.
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.