Repository navigation
Releases
Releases · dmonza/fetchpier
Fetchpier 0.9.6
[0.9.6] - 2026-11-04
The command-line interface becomes reliable in continuous integration, and the
desktop app gains the engine changes that make that possible. Several of these
change behavior on purpose; they are marked Behavior change.
Fixed
- Values set by a script now reach the next request of a run. A token a login
request stores withfp.environment.setis used by the authenticated call that
follows;fp.environment.removeis carried the same way. It was dropped, so the
call failed with a 401. - Secrets no longer leak through scripts. What a script logs, a test's name,
a failed assertion's message and a script error now show a secret as
{secret:<name>}in the terminal, every report, the run history and the
desktop's script console — including a value a script itself writes under a
secret variable's name. - Binary request bodies are sent by the command line. A request whose body
is an attached file used to go out with an empty body. A missing file, or a
reference in the request file that is not valid, now fails that request as
"not run" instead of sending it empty. (Behavior change) - Compressed responses are decoded (
gzip,deflate,br) on both the
desktop and the command line, so assertions and the viewer read the real
body. A body that cannot be decoded is kept as received, with a warning, and
fp.response.json()fails with that cause. The activity log records a decoded
compressed text response as text. - Runs that did nothing no longer pass. A target folder with no request
stops the run with exit code19(Behavior change). - Values the command line could not honour are refused.
--timeoutand
--delayaccept whole numbers from0to2147483647; anything else is a
usage error (exit3) instead of being ignored. (Behavior change) - Unreadable configuration stops the run. An unparseable
.fetchpier/settings.json, or an unparseableconfig.jsonfor the selected
environment, exits with code4naming the file, instead of running with
defaults (which dropped the TLS settings) or reporting the environment as
missing.fp env listwarns about unreadable environments. An environment
file that parses but lacks anameorid(or whosevariablesis not an
object) counts as unreadable too: it used to crash everyfp runand
fp env listin the workspace with an internal error, even when another
environment was selected. (Behavior change) - The terminal shows the environment by its folder name instead of its internal
identifier,-v/-vv/-vvvnow add detail, and script output (fp.log)
is shown in runs of several files. - An expired timeout is reported as
timed out after <limit>on both surfaces,
not as a cancellation. - No internal diagnostic lines (
[execute] …,[parser] …) reach the output;
they are warnings, also in the JSON report with a stable code. - The default
User-Agentno longer advertises version 0.1.0. - The "Did you mean …?" hint for a missing path is correct when the current
directory or the workspace is reached through a symbolic link (as macOS's
temporary folders are); it used to suggest a path climbing to the root.
Added
- Proxy support for the command line:
HTTPS_PROXY/HTTP_PROXY/
NO_PROXY,--proxy <url>and--no-proxy. The header names the proxy and
the exclusion list; at-veach request says whether it went through the
proxy or directly. An unusable proxy URL stops the run (exit3). --persist-envsaves script variable changes to the local values exactly
as the desktop does. Without it a run writes nothing to the workspace.- Redaction of credentials and cookies in the command line's terminal output
and reports: the API-key auth credential (query or header) andCookie/
Set-Cookievalues, in addition toAuthorization.--show-secretsreveals
them. The run history (--save-history) is unchanged. - A warning when a variable a request uses comes from a
{{$env.NAME}}that is
not defined anywhere, so it was sent empty. - Advisories that used to be log lines are now shown: a cookie jar or TLS
material that could not be used, an HTTP/2 downgrade, a replaced multipart
Content-Type, a script write that could not be saved — in the command line's
warnings and, on the desktop, in a dismissible notice above the response. - The JSON report gains optional fields:
environmentName, and per response
compressedBytes,decompressedBytesanddecodingStatus; per request
notRunandvia. Its version stays1.0. Scripts gain
fp.response.decodingStatus. - The response viewer shows both the received and the decoded size of a
compressed response, and flags a body that could not be decoded.
Changed
- Default per-request timeout of 30 seconds on the command line (the
desktop's default).--timeout 0is the only way to disable it. (Behavior change) Accept-Encoding: gzip, deflate, bris sent by default on both surfaces
when a request does not set it. (Behavior change)- Default
User-Agent:Fetchpier/<app version>from the desktop and
Fetchpier-CLI/<CLI version>from the command line, applied at send time and
never written into request files; both defaults show in the headers editor as
read-only rows. A value already saved in a file is still sent as written.
(Behavior change) - A request that got no response reads
no response: <reason>when a send was
attempted andnot run: <reason>when it was not; the JUnit test case is
renamed fromrequest not sentaccordingly. (Behavior change) - A value a script sets wins over
--env-varfrom that point on. - The CLI reference documents TLS configuration, missing-variable behavior, the
limits of secret masking, that the history keeps cookie values, and that the
CLI may align an environment's display name with its folder.
[0.9.5] - 2026-11-04
Command-line interface fixes and publication readiness for @fetchpier/cli.
Fixed
fp runwith no path now runs every request under the workspace's
requests/folder from any directory — a subfolder of the workspace, or
from outside it with--workspaceorFETCHPIER_WORKSPACE. It used to work
only from the workspace root and otherwise failed with "Path not found".- The command
fp initsuggests at the end (fp run --workspace <name>, or
fp runwhen initializing the current folder) now works as printed; the
previous suggestion failed when copied from the same directory. --bailnow also stops after a request that got no response (unreachable
host, refused connection, timeout, TLS failure), not only after a failed
test or script error — the same rule the exit code already applied.- The npm package is always built from the sources being packed or published,
instead of shipping whatever the last local build left in place.
Added
- When a path given to
fp rundoes not exist in the current directory but
does inside the workspace, the error suggests the path to type instead. - The npm package ships the license notices of the third-party code bundled
into it.
Changed
- The CLI reference (the package README) was rewritten to match the tool: the
real Node.js minimum (22.19), which commands need a workspace, every flag and
exit code, the environment variables it reads, using secrets in CI, and CI
examples that work as written. The CLI examples in the project README were
corrected to match.
Fetchpier 0.9.4
First public release — a public beta. The 0.9.x line was developed privately, so these notes describe what Fetchpier does today rather than what changed against a version nobody could install.
Downloads
| Platform | File |
|---|---|
| Windows | Fetchpier-Installer-0.9.4.exe |
| macOS (Apple Silicon) | Fetchpier-0.9.4-mac-arm64.dmg |
| macOS (Intel) | Fetchpier-0.9.4-mac-x64.dmg |
| Linux | .AppImage (any distribution) or .deb (Debian/Ubuntu) |
Installers are not code-signed yet
- Windows: SmartScreen → More info → Run anyway.
- macOS: System Settings → Privacy & Security → Open Anyway.
- Linux: AppImage and .deb are unsigned, as is conventional.
What's in 0.9.4
Requests and collections
- Requests are plain
.httpfiles and collections are folders on disk — the same format VS Code REST Client and JetBrains HTTP Client read. Nothing to export in order to leave. - Full HTTP support: methods, headers, query and path parameters, and raw, JSON, urlencoded, binary and
multipart/form-databodies. - Round-trip fidelity: a request read and written back produces the same file, so Fetchpier is safe to point at a collection kept under version control.
- Request instances — several saved parameter sets for one request, without duplicating the file.
- Preview tabs, session restore, and real-time file watching: edit a request in any editor and the app follows along.
Environments and variables
{{var}}substitution with autocomplete, inline highlighting and dynamic variables for values generated per run.- Secret variables encrypted at rest with XChaCha20-Poly1305, with the workspace key held in the operating system keyring — never in the workspace folder.
- Local and unshared values: the variables that must not travel with the repository stay on the machine that defined them.
Authentication and TLS
- Bearer, Basic and API key, with the selected scheme persisted in the
.httpfile and restored when the request is reopened. - Dual certificate scoping: a workspace scope that travels with Git, and a global app scope. The bundled CA set deliberately ignores the OS trust store, so corporate CAs are imported explicitly and MITM proxy environments behave predictably.
- Authorization headers are stripped on cross-host redirects by default.
- Cookie jar per environment, conformant with RFC 6265.
Scripting
- Pre-request and post-response scripts against a small, auditable
fp.*API, running in an isolated synchronous sandbox with a wall-clock budget. - Typed access to the parsed response body, with editor diagnostics and autocompletion driven by the same types.
Schema import
- OpenAPI 2.x and 3.x including Swagger, in JSON and YAML.
- GraphQL SDL and introspection.
- WSDL / SOAP, with a ready-to-edit envelope generated from the schema.
- Postman collections v2.0 and v2.1.
Command-line interface
fp, a Node CLI that runs requests and inspects environments of a Fetchpier workspace from the terminal, sharing the same engine as the desktop app.
Application
- Windows, macOS and Linux, with installers for each.
- Light and dark themes, English and Spanish, command palette and keyboard navigation across the tree and tabs.
- Detachable Activity panel — history and run output in its own window.
- On-demand version check that reports a newer release and links to this Releases page; it never downloads or installs anything on its own.
Security posture
- The UI process runs inside the operating system renderer sandbox, with no Node runtime. Privileged work happens in the main process behind validated IPC.
- Declared network egress: apart from the version check you trigger yourself, every connection originates from your request configuration. No telemetry, no background traffic, no remote content in the UI.
Bug reports and questions: Issues · Discussions. Security issues: see SECURITY.md.