Resto
A CLI app can send pretty HTTP & API requests with TUI.
Installation
Using script
- Shell
curl -fsSL https://git.io/resto | bash
- PowerShell
iwr -useb https://git.io/resto-win | iex
then restart your powershell
Go package manager
go install github.com/abdfnx/resto@latest
GitHub CLI
gh extension install abdfnx/gh-resto
Via Docker
docker run -it restohq/resto <CMD>
full container:
docker run -it restohq/resto-full
Usage
- Open Resto UI
resto
- Send a request to a URL
resto get https://api.github.com
- Send a request to a URL and use resto editor
resto post https://localhost:3000/v1/login --content-type json --editor
- Read Body from stdin
cat schema.graphql | resto post https://api.spacex.land/graphql --content-type graphql --body-stdin
- Use Authentecation with Basic Auth or Bearer Token
# Bearer Token
resto delete https://api.secman.dev/api/logins/13 --content-type json --token TOKEN
# Basic Auth
resto delete https://api.secman.dev/api/logins/13 --content-type json --username USERNAME --password PASSWORD
- Save response to a file
resto get http://localhost:3333/api/v1/hello --save response.json
- Install binary app from script URL and run it.
resto install https://yarnpkg.com/install.sh
resto i https://get.docker.com
- Send a request from Restofile
resto run
# from path
resto run --file ./examples/restofile/basic_request/Restofile
- Get the latest release/tag from repository
resto get-latest abdfnx/resto
# use another registry
resto get-latest 23028539 --registry gitlab.com
# with access token
resto get-latest spittet/node-postgresql --registry bitbucket.org --token YOUR-ACCESS-TOKEN
Flags
-
GET
&HEAD
flags
-H, --headers Just show the response headers
-j, --just-body Just show the response body
-p, --password string The password to use for basic authentication
-s, --save string Save the response body to a file
-t, --token string The bearer token to use for authentication
-u, --username string The username to use for basic authentication
-
POST
,PUT
,PATCH
,DELETE
flags
-b, --body string The body of the request
-i, --body-stdin Read the body from stdin
-c, --content-type string The content type of the body
-e, --editor Open the editor to edit the body
-H, --headers Just show the response headers
-j, --just-body Just show the response body
-p, --password string The password to use for basic authentication
-s, --save string Save the response to a file
-t, --token string The bearer token to use for authentication
-u, --username string The username to use for basic authentication
-
install
command flags
-H, --hidden hide the output
-s, --shell string shell to use default: bash
-
run
command flags
-a, --all Show all response headers & status
-f, --file string Path to Restofile (Default: PATH/Restofile)
-
get-latest
command flags
-r, --registry string The registry to use
-t, --token string The access token to use it the registry requires authentication
Shortcuts
- Ctrl+P: Open Resto Panel
- Ctrl+H: Open Help Guide
- Ctrl+S: Save Request Body
- Ctrl+Q: Quit
Documentation
Refer to our Wiki for the documentation.
thank you for your time and don't forgot to star the repo if you like it
Top comments (3)
Does the theming works? I tried and however catppuccin messed up with the request form fields. Want to change the theme but wiki does not provide anything
Some comments may only be visible to logged-in visitors. Sign in to view all comments.