Command Reference
Complete list of all tgrs flags and options. Use tgrs --help to see this in your terminal.
Usage
tgrs [METHOD] URL [KEY:VALUE ...] [OPTIONS]
tgrs run [PATH] [OPTIONS]
tgrs update
Request
| Flag | Alias | Description |
|---|---|---|
| -X | --method | HTTP method (GET, POST, PUT, PATCH, DELETE, ...) |
| -I | --head | Send HEAD request |
| -H | --header | Add header (repeatable) |
| --headers | Add multiple headers: comma-separated or JSON object | |
| -d | --data, --body | Raw request body. Use @filename to read from file |
| -f | --form | Use form encoding instead of JSON |
| -F | --file | Multipart form field (repeatable) |
| -A | --user-agent | Set User-Agent header |
| -e | --referer | Set Referer header |
| -b | --cookie | Send cookies: inline or @file |
Authentication
| Flag | Alias | Description |
|---|---|---|
| -u | --auth | Basic auth (user:password) |
| -B | --bearer | Bearer token |
| -K | --api-key-query | API Key as query parameter (key=value) |
| --oauth2 | OAuth 2.0 (flow:token_url:client_id[:client_secret]) | |
| --oauth2-scope | OAuth 2.0 scope | |
| --oauth2-auth-url | OAuth 2.0 authorization URL | |
| --oauth2-username | OAuth 2.0 username (password flow) | |
| --oauth2-password | OAuth 2.0 password (password flow) | |
| --oauth2-port | OAuth 2.0 callback port (default: 8484) |
Response Display
| Flag | Alias | Description |
|---|---|---|
| -v | --verbose | Show request + response + timing + size |
| --response-headers | Show only response headers | |
| --response-body | Show only response body | |
| -p | Fine-grained: H=req headers, B=req body, h=res headers, b=res body | |
| --raw | No colors, no formatting | |
| --json | Full JSON output for CI/CD | |
| -r | --dry-run | Show request without sending |
| -s | --silent | Silent mode — no extra output |
| --no-compressed | Disable automatic response decompression | |
| -t | --trace | Detailed timing breakdown per request phase |
Connection
| Flag | Alias | Description |
|---|---|---|
| -L | --follow | Follow redirects |
| --max-redirects | Max redirects to follow (default: 10) | |
| -m | --timeout | Total timeout in seconds |
| --connect-timeout | Connection timeout in seconds | |
| -k | --insecure | Skip SSL verification |
| -x | --proxy | Proxy URL |
| --retry | Retry failed requests N times (default: 0) | |
| --retry-delay | Base delay between retries in seconds (default: 1) | |
| --resolve | Override DNS resolution (HOST:PORT:ADDR) | |
| -S | --max-filesize | Maximum response body size in bytes |
Protocol
| Flag | Alias | Description |
|---|---|---|
| --http1.1 | Force HTTP/1.1 | |
| --http2 | Force HTTP/2 | |
| --http3 | Force HTTP/3 (QUIC) | |
| -C | --cert-info | Show TLS certificate info |
Session & Storage
| Flag | Alias | Description |
|---|---|---|
| -N | --session | Named session — persists cookies and headers |
| -o | --output | Save response body to file |
| -D | --download | Download with progress bar (optional filename) |
| -c | --cookie-jar | Write cookies to file |
Assertions
| Flag | Alias | Description |
|---|---|---|
| -a | --assert | Assertion expression (repeatable, comma-separated) |
Operators: equals (eq), not_equals (neq), contains, not_contains, greater_than (gt), less_than (lt), exists, not_exists, is_empty, is_not_empty, matches_regex, is_type
Info
| Flag | Alias | Description |
|---|---|---|
| -h | --help | Print help (-h summary, --help detailed) |
| -V | --version | Print version |
| --licenses | Show third-party library licenses |