Editors: Web UI, Desktop app & VS Code

TruSpec is CLI-first, but optional surfaces let you work with collections visually — a local web UI (also installable as a native desktop app) and a VS Code extension. All of them run requests locally through the engine (no CORS, no cloud), so they behave identically to truspec run.

Web UI

truspec serve opens a local web app for a collection. Requests execute server-side through @truspec/core, so there are no browser CORS limits — the UI is just a front-end over the same engine the CLI uses.

bash

truspec serve --dir ./api      # opens http://localhost:4100

Flag	Alias	Default	Description
`--dir <collection>`	`-d`	`.`	Collection directory to serve.
`--port <n>`	`-p`	`4100`	Port.

Screens:

A collection sidebar listing your requests.
A request view to run a request and see its assertions.
A results panel with status, timing, and assertion outcomes.
A spec view showing drift and coverage.

It's dark/light aware, keyboard-friendly, and self-hosts its fonts so it works fully offline.

The web UI is bundled when you install truspec from npm. From a source checkout, build it first with pnpm --filter @truspec/web build; otherwise truspec serve will tell you it isn't available.

The web UI is read-and-run focused today; in-UI request editing is on the roadmap. For authoring, edit the .tspec.yaml files directly (with schema-backed autocomplete) or use the VS Code extension below.

Flow view

Click Flow in the nav to see a directory's requests laid out in run order, with capture -> consume dependency edges drawn between them — so the chaining built from order + capture + {{var}} interpolation (see Chaining with capture) is visible instead of only readable file-by-file. Each edge is colored by whether the last run actually produced that value (unrun / ok / broken). Click a step to see its assertions, captures, and resolved values, or click Run flow to execute the whole chain in place. You can also import a Postman collection or a Bruno folder directly from this view.

Desktop app

TruSpec Desktop wraps the same web UI in an installable native window (built with Tauri) — no Node install required, and no separate logic from the CLI/web server underneath.

Download the latest installer →

Windows — .exe (NSIS) or .msi
macOS — .dmg (Apple Silicon; runs on Intel Macs too, under Rosetta 2)
Linux — .AppImage, .deb, or .rpm

These are unsigned builds for now (no code-signing cert or Apple notarization yet), so your OS will warn on first launch:

Windows: SmartScreen shows "unknown publisher" — click More info → Run anyway.
macOS: Gatekeeper quarantines the download — run xattr -cr /Applications/TruSpec.app once, then open it.
Linux: no equivalent warning.

On first launch the app asks you to pick a collection directory (remembered for next time), spawns the same server truspec serve uses as a background process, and opens a native window pointed at it — closing the window shuts that process down cleanly.

VS Code extension

TruSpec for VS Code runs .tspec.yaml requests and checks OpenAPI drift & coverage without leaving your editor. Requests execute in the extension host via @truspec/core — no CORS, fully local.

Features:

CodeLens on every .tspec.yaml: ▶ Run · Run collection · Drift · Coverage.
Commands (⇧⌘P): TruSpec: Run Request / Run Collection / Drift / Coverage.
Results render in a side panel — status, timing, assertions, plus drift and coverage views.
The truspec.environment setting picks the environment (otherwise you're prompted).

The extension is pre-release; it isn't on the Marketplace yet. To run it from a source checkout: pnpm --filter truspec-vscode build, then press F5 in the repo (the Run TruSpec Extension launch config) to open an Extension Development Host on examples/blog, open a .tspec.yaml, and click the ▶ Run CodeLens.

Schema-backed editing in any editor

You don't need an extension to get autocomplete and validation while editing files — point your editor's YAML language server at the published JSON Schemas:

jsonc

// .vscode/settings.json
{
  "yaml.schemas": {
    "./node_modules/@truspec/core/schema/request.schema.json": "*.tspec.yaml",
    "./node_modules/@truspec/core/schema/environment.schema.json": "environments/*.env.yaml"
  }
}

This works with the Red Hat YAML extension in VS Code and any editor backed by the YAML language server.

Editors: Web UI, Desktop app & VS Code ​

Web UI ​

Flow view ​

Desktop app ​

VS Code extension ​

Schema-backed editing in any editor ​

See also ​