No Description

gwillz 060fe79484 1.8.10 3 months ago
.vscode 30fdda7457 Update host:port for tests. 4 months ago
src d29e86169d Parse request breaks as tokens. 3 months ago
tests 7b851003f0 Fix jsonpath arrays. 3 months ago
.gitignore 2ea6955264 Initial parser. 1 year ago 6fd5564924 Added readme, license. 1 year ago 93c9399f9a Update readme usage + todos. 4 months ago
_config.yml c7817212b5 Set theme jekyll-theme-tactile 10 months ago
package-lock.json 060fe79484 1.8.10 3 months ago
package.json 060fe79484 1.8.10 3 months ago
tsconfig.json dc6c171db0 Fix tests missing types. 8 months ago

Rest CLI

A request runner inspired by REST Client.

This tool is intended to be compliant with Hauchao's VSCode plugin so that requests can be sequenced via command line tools.

There is no intention to extend features in this project beyond what is already capable in the plugin. Ideally, one can execute the very same files with the same environment interchangeably between the plugin and this tool.

If you need extra features, feel free to fork this project.


npm install -g rest-cli

# A single file, simple output.
# Shows stats, request method, and URL.
restcli myrequest.http

# A sequence of files.
restcli requests/*.http

# All .http files in the current directory.
restcli .

# Modify retry count (default: 3).
restcli --retry 5 myrequest.http

# A named request within a file.
restcli --pick myname myrequest.http

# Hide the stats (1: [2]).
restcli --no-stats myrequest.http

# Show different level of information.
restcli --show headers myrequest.http
restcli --show body myrequest.http
restcli --show full myrequest.http
restcli --show exchange myrequest.http

# Use production env variables.
restcli --env production myrequest.http

# Load in a json file of variables.
restcli --env env.json myrequest.http

# Disable colour.
restcli --no-color myrequest.http


This package exports a file parser and utilities for automating your requests.

See the main.ts file for extended usage.

Typescript defs are also exported.


import { RestParser } from 'rest-cli';

(async () => {
    const parser = new RestParser();
    await parser.readFile("./myrequest.http");
    const request = await parser.get(0);
    const { response } = await request.request();

Node v8

This uses async iterators and therefore only supports Node v10. Note, as of January 2020, Node v8 is end-of-life and unsupported. If you really need Node v8, you can hack a solution with the --harmony_async_iterator flag.

Something like:

echo "#!/usr/bin/node --harmony_async_iterator" > restcli
echo "require('rest-cli').main()" >> restcli
chmod +x restcli

HTTP Language

This follows the standard RFC 2616, with templating as defined by vscode-restclient.

Example file

@baseUrl =

# @name login
POST {{baseUrl}}/api/login HTTP/1.1
Content-Type: application/x-www-form-urlencoded



@authToken = {{login.response.headers.X-AuthToken}}

# @name createComment
POST {{baseUrl}}/comments HTTP/1.1
Authorization: {{authToken}}
Content-Type: application/json

    "content": "fake content"


@commentId = {{createComment.response.body.$.id}}

# @name getCreatedComment
GET {{baseUrl}}/comments/{{commentId}} HTTP/1.1
Authorization: {{authToken}}


# @name getReplies
GET {{baseUrl}}/comments/{{commentId}}/replies HTTP/1.1
Accept: application/xml


# @name getFirstReply
GET {{baseUrl}}/comments/{{commentId}}/replies/{{getReplies.response.body.//reply[1]/@id}}

Not supported

  • $aadToken
  • extension (%varname) environment variables

Supported Rest-Client settings

It's lies, only environmentVariables is currently supported.

Below are defaults.

  "rest-client.certificates": {},
  "rest-client.environmentVariables": {
    "$shared": {}
  "rest-client.decodeEscapedUnicodeCharacters": false,
  "rest-client.defaultHeaders": {
    "User-Agent": "vscode-restclient"
  "rest-client.excludeHostsForProxy": [],
  "rest-client.followredirect": true,
  "rest-client.formParamEncodingStrategy": "always",
  "rest-client.rememberCookiesForSubsequentRequests": true,
  "rest-client.timeoutinmilliseconds": 0,


There's a lot to do to complete this tool. Most of these are things that are missing to make it more compatible with the plugin.

Feel free to jump in on any of these.

  • just use yargs already
  • variables should be recursively interpolated when used - instead of statically
  • GraphQL support
  • multipart file loading support
  • cookies??
  • more doc comments
  • better readme docs
  • interpolating {{$shared name}} in environment files

Per-request settings:

  • escaped unicode
  • follow redirects
  • form param encoding
  • preview option (overrides CLI + settings)
  • remember cookies
  • timeout


  • functions
  • request (fill, slug, body)
  • restfile
  • utils (basicAuth, bodyAsString, ServerError)
  • parser (out-of-order, iterator, get)

CLI options:

  • timeout
  • config file
  • disable confirm prompts
  • save to folder (optionally just files or everything)


  • certificates
  • escaped unicode
  • default headers
  • follow redirects
  • form param encoding
  • preview option (overridden by CLI + per-request setting)
  • proxy exclude hosts
  • remember cookies
  • timeout