github unkn0wn-root/resterm v0.28.1

6 hours ago

What's New

resterm run command - resterm directly from CLI

The biggest addition in this release is being able to run resterm directly via command line. Resterm run lets you execute .http / .rest files directly without opening the TUI. This was something that came up frequently so it is now possible to just fire requests via CLI instead of opening resterm in TUI mode.

# Run a single request file
resterm run ./requests.http

# Run all requests from given .http file
resterm run --all ./requests.http

# Run a named request with raw unformatted output
resterm run --request login --format raw ./requests.http

# Run a workflow
resterm run --workflow smoke ./requests.http

# Run all requests tagged "smoke" and output JSON
resterm run --tag smoke --format json ./requests.http > run.json

# Print only the raw response body
resterm run --request create-user --body ./requests.http

# Read from stdin
cat ./requests.http | resterm run - --request health

Supports multiple output formats (text, json, junit, pretty, raw), selector flags (--request, --workflow, --tag, --line, --all, --profile), artifact writing (--artifact-dir), and persisted state between invocations (--persist-globals, --persist-auth, --history).

Interactive Request Picker

When running a multi-request file without a selector, resterm run launches an interactive picker to let you choose which request to execute.

# Launches picker when file has multiple requests
resterm run ./requests.http

Profile Histogram

Profiling results include a color coded latency distribution histogram directly in the terminal. Buckets are colored by percentile thresholds (p50/p90). It's almost the same style like in TUI.

# Profile a request and see the histogram
resterm run --request health --profile ./requests.http

CLI Documentation

New docs/cli.md covering all resterm run flags, output formats, selectors, artifacts, exit codes, and examples.


Bug Fixes

  • Auth command cache scoping - Fixed authcmd cache key scoping to include both environment name and workspace root, and corrected source-dir resolution to prefer auth.SourcePath when available.
  • Binary view MIME extensions - Filename hints for binary response downloads now use stable, preferred MIME extensions instead of non-deterministic ones from the standard library.
  • Telemetry config - Fixed telemetry configuration initialization.

Don't miss a new resterm release

NewReleases is sending notifications on new releases.