CLI Mode

Execute requests from the command line.

Basic Usage

restcli <file>

Or explicit:

restcli run <file>

File extension is optional:

restcli get-user

Finds get-user.http, get-user.yaml, get-user.json, or get-user.jsonc.

Flags

Profile

restcli -p Dev request.http

Short: -p
Long: --profile

Output Format

restcli -o json request.http

Options: json, yaml, text

Short: -o
Long: --output

Full Output

restcli -f request.http

Includes status line, headers, and body.

Short: -f
Long: --full

Save Response

restcli -s response.json request.http

Short: -s
Long: --save

Override Body

restcli -b '{"key":"value"}' request.http

Short: -b
Long: --body

Set Variables

restcli -e userId=123 -e token=abc request.http

Repeatable flag for multiple variables.

Short: -e
Long: --extra-vars

Environment File

restcli --env-file .env request.http

Load variables from file.

Filter

restcli --filter "items[?status==\`active\`]" request.http

JMESPath filter expression.

Query

restcli -q "[].name" request.http

JMESPath query or bash command.

Short: -q
Long: --query

Stdin Body

Pipe data directly:

cat payload.json | restcli request.http

Or:

echo '{"data":"value"}' | restcli post-data.http

Stdin overrides body in request file.

Combining Flags

restcli run api.http \
  -p Production \
  -o json \
  -e apiKey=secret123 \
  -e version=v2 \
  --filter "results[?active]" \
  -s output.json

Exit Codes

Code	Meaning
0	Success
1	Request failed or error
2	Missing variables

Scripting

Check Response

restcli health.http -o json | jq '.status == "ok"'

Variable Extraction

TOKEN=$(restcli login.http -o json | jq -r '.token')
restcli -e token=$TOKEN get-data.http

Loop Requests

for id in {1..10}; do
  restcli get-user.http -e userId=$id -o json >> results.jsonl
done

Conditional Execution

if restcli health.http -q '.status' | grep -q 'ok'; then
  restcli deploy.http
fi

Interactive Variables

If variables are missing and not provided via flags, CLI prompts for input:

restcli get-user.http
# Prompts: Enter value for userId:

Disable prompts in scripts by setting all variables via flags or profiles.

Examples

Basic request:

restcli get-user.http

With profile and variables:

restcli -p Dev -e userId=5 get-user.http

JSON output saved to file:

restcli api.http -o json -s result.json

Filter and query:

restcli users.http \
  --filter "users[?age > \`18\`]" \
  --query "[].{name: name, email: email}"

Pipe stdin body:

cat new-user.json | restcli create-user.http -o json

Full output with headers:

restcli -f auth.http