App v0.3.18

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version package (78003a6)
• fix(app): make Enter drill into directories in file tree (#125) (cfd84e8)

App v0.3.17

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (bce6789)
• feat(app): add file tree in layout (#124) (d4563b3)
• feat(app): move output into right-side details and stabilize tab rend… (#123) (cc94276)

App v0.3.16

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (#117) (7aeed05)
• feat: propagate profile through script and test runners (#116) (1c629f7)

App v0.3.15

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (d8fc055)
• refactor(app): extract file-type helpers into shared utils (#113) (915f7d2)
• docs(app): update description and keywords for app npm package (cbd493c)
• fix(app): enable syntax highlighting for JSON, HTML, and YAML (#111) (fc1595d)
• fix(app): footer copy spacing (#110) (1dffcfa)
• refactor(app): hoist runEngine to eliminate duplication (#109) (098ce7e)

App v0.3.14

Features

Startup Auto-Update for Interactive Commands

The open, tui, and web commands now automatically check for updates on startup:

• CLI Control: Use --auto-update or --no-auto-update flags to enable/disable per command (default: enabled)
• Environment Variable: Set TREQ_AUTO_UPDATE=false to disable globally
• TUI Notifications: Toast notifications show update availability and progress in the TUI

---

Fixes

TUI Modal List Overflow
Fixed picker lists in modals overflowing beyond their bounds. Lists now properly constrain to modal dimensions with scrollbox support, and scroll index logic has been centralized for consistent navigation across all pickers.

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (#104) (92cfd11)
• feat(app): add startup auto-update for interactive commands (#96) (2e90d86)
• Fix(app)/tui modal list overflow (#99) (b51beac)

App v0.3.13

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (#98) (a67320c)
• fix(app): init templates now place assert directives at the top of the generated .http files so it matches plugin expectations (#97) (cf097c7)

App v0.3.12

Release

What's New

WebSocket Foundation Support (Protocol v1.1)

The platform now supports WebSocket connections as a first-class protocol alongside HTTP and SSE.
Core (@t-req/core v0.2.5)

• Added ws as a first-class protocol (http | sse | ws)
• New protocol options:
  • @ws - Mark requests as WebSocket
  • @ws-subprotocols - Specify subprotocols
  • @ws-connect-timeout - Configure connection timeout
• Auto-detection for ws:// and wss:// URLs
• Full backward compatibility with HTTP/SSE behavior
  App (@t-req/app v0.3.12)
• New WebSocket execution endpoint: POST /execute/ws
• Session management: GET /ws/session/{wsSessionId}
• Observer WebSocket transport: GET /event/ws (alongside existing SSE /event)
• Bounded replay support via afterSeq for seamless reconnection
• Protocol version bumped to 1.1 with WebSocket feature flags
  SDK (@t-req/sdk v0.1.3)
• Regenerated with full WebSocket endpoint support
• New typed WebSocket helpers:
  • connectObserverWs() - Observer pattern WebSocket connection
  • connectRequestWsSession() - Connect to specific request session
  • executeAndConnectRequestWs() - Execute and connect in one call
• Built-in reconnect/resume support with afterSeq tracking
• Typed envelope iteration for message handling
  cURL Import Support
• New typed cURL import helpers in SDK
• Full cURL importer core workflow in core package
• Structured OptionDefinition and ParseContext for clean configuration parsing
  Enhanced HTTP Body Editing
• New parse body/spans contract for JSONC-aware inline body editing
• Improved handling of JSON-with-comments format

---

Bug Fixes

• Fixed plugin runtime cache issue

---

Compatibility Notes

• Additive release: All existing /execute, /execute/sse, and /event flows continue to work
• Protocol v1.1 WebSocket .http definitions are connection metadata only (no request body/file/form-data execution in this version)
• Binary WebSocket payloads remain unsupported in v1.1

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (#95) (746feff)
• featu(app): add parse body/spans contract and jsonc-safe inline body editing (db6027a)
• Add curl importer core workflow (#77) (0cc33cf)
• feat(desktop): desktop file tree (#75) (378d1bf)
• feat(cli): add file mode support to WebSocket command (#73) (1df41aa)
• feat(app): add websocket CLI command with interactive and automation modes (#72) (dcd7e2e)
• Fix/plugin runtime cache (#71) (3d5a04d)
• docs: websocket documentation for api, sdk (8d78e06)
• feat: websocket observer transport and sdk helpers (#69) (9120305)
• feat(app): wire WS execution endpoints and control sockets (#68) (465969b)
• feat(app): add websocket session manager with replay buffer (#67) (5071a14)
• feat: add WebSocket protocol types and server API contracts (#66) (42a0f07)

App v0.3.11

Postman Collection Import (treq import postman)

You can now import Postman collections directly into t-req projects:
treq import postman collection.json --output ./requests
Features:

• Full support for Postman v2.1 collections
• Import requests, folders, variables, authentication, and bodies
• Configurable conflict resolution strategies
• Variable merge options (override, merge, or skip)
• Dry-run mode to preview changes without writing files
• Colored diagnostic output for debugging import issues

---

Source-Agnostic Import System

A new extensible import framework enables importing from any source:

// Preview changes before applying
const preview = await client.importPreview('postman', {
  source: collectionData,
  options: { outputDir: './requests' }
});
// Apply with full control
const result = await client.importApply('postman', {
  source: collectionData,
  options: { outputDir: './requests', force: true }
});

New API Endpoints:

• POST /import/{source}/preview — Preview filesystem changes without writing
• POST /import/{source}/apply — Apply changes with conflict resolution
• Supports per-importer options validation
• Partial failure handling (HTTP 207 with partialResult)
• Security: Script-scoped tokens blocked (403)

---

HTTP File Serialization

New APIs for programmatically writing .http files:

import { serializeRequest, serializeDocument } from '@t-req/core';
// Serialize a single request
const httpText = serializeRequest(request);
// Serialize entire document with multiple requests
const documentText = serializeDocument({
  requests: [request1, request2],
  variables: { baseUrl: 'https://api.example.com' }
});

Features:

• Deterministic, parser-compatible output
• Supports all request features (headers, body, form data, auth)
• New SerializableRequest and SerializableDocument types
• Full test coverage for round-trip serialization

---

Enhanced Request Model

RequestDefinition now supports richer metadata:

interface RequestDefinition {
  description?: string;      // Human-readable description
  bodyFile?: string;         // Reference external body file
  formData?: FormDataEntry[]; // Multipart form data
  directives?: Directive[];   // @-directives (e.g., @assert)
  // ... existing fields
}

This enables better integration between the CLI, server, and SDK.

SDK Improvements

• New methods: TreqClient.importPreview() and TreqClient.importApply()
• Better error handling: SDKError with structured error information
• Convenience utilities: unwrap() method for cleaner async/await patterns

---

Full changelog: See individual package CHANGELOGs for complete details

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore: version packages (988e0e3)
• feat(core): expand RequestDefinition and implement writeHttpFile (#62) (bdd0556)
• feat(app): add source-agnostic import preview/apply endpoints and reg… (#61) (b0150a2)
• Feat(app)/add import postman cmd (#60) (a7bb6dc)
• feat(app): add Import Service for orchestrating import operations (#59) (997c6c7)
• fix(app): add pluginReport to EventTypeSchema (#49) (8f062bb)

App v0.3.10

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• chore(app): bump version to 0.3.10 (5d3e48d)
• feat(app): add template selection with empty and basic options (#48) (6b11554)
• fix lint errors (70fdf03)

App v0.3.9

Installation

curl (recommended)

curl -fsSL https://t-req.io/install | bash

npm

npm install -g @t-req/app

Manual download

Download the appropriate archive for your platform from the assets below.

Changes

• fix(init): add @t-req/plugin-base to generated dependencies (464f838)
• resolve dependency error (4c4502c)