
[](#)
[](https://www.rust-lang.org)
[](LICENSE)
[]()
[](http://makeapullrequest.com)
[](https://github.com/hars-21/reqsh)
Interactive HTTP shell for API workflows. Send requests, manage headers & variables and rerun past commands from a terminal REPL.
## Features
- Interactive REPL with multi-line request editing
- Send GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS requests (case-insensitive)
- Multi-line request input with query params, headers, body and `###` terminator
- Persistent session state across restarts (`~/.reqsh_state.json`)
- Variable interpolation with `{{name}}` syntax in paths, headers, query params and bodies
- Global headers and variables (`header`, `var`)
- Save, manage and run requests in-session (`req`)
- Re-run the last executed request (`req rerun`)
- Save the last response body to a file (`req save-response <path>`)
- Command history with show, rerun and clear
- Configurable request timeout
- JSON response pretty-printing with colored output
## Quick Start
### Install
```bash
Or via Homebrew:
```bash
brew tap hars-21/tap
brew install reqsh
```
Or via Cargo:
```bash
cargo install reqsh
```
You can also download a binary from the [releases page](https://github.com/hars-21/reqsh/releases/latest) or [build from source](docs/install.md).
### Demo
https://github.com/user-attachments/assets/2e2280cd-d754-4726-81ab-ebc5c393f6d6
### Usage
```bash
reqsh> base https://api.example.com
reqsh> GET /users
.....> ###
reqsh> POST /users
.....> Content-Type: application/json
.....>
.....> {"name": "john"}
.....> ###
```
For full documentation on commands, variables and usage see the [docs](docs/introduction.md).
## Contributing
Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## License
MIT. See [LICENSE](LICENSE) for details.