v0.1.0

Release Notes

v0.1.0

v0.1.0 is the first tagged release of openrun, a spec-driven Go library, CLI,
and MCP server for exercising HTTP APIs directly from OpenAPI 3.x documents.

Highlights

• Load and validate runner-facing OpenAPI fields, discover operations, generate
  request templates, emit curl commands, and send requests.

• Use compact project-aware commands such as:

  openrun run getUser -p id=42
  openrun run createUser -d @body.json

• Run sequential or bounded-parallel collections with assertions, schema
  validation, retries, timeouts, dependencies, skip conditions, extraction, and
  transactional hooks.

• Reuse named environments, collection defaults, and OpenAPI-declared bearer or
  API-key authentication.

• Import and export the supported subset of Postman Collection v2.1.

• Use openrun as a Go library in ordinary tests.

MCP and apiary

The release includes openrun-mcp, a stdio MCP server with tools for:

• spec validation and operation discovery;
• request templating and curl generation;
• running one operation or a collection;
• generating OpenAPI through apiary;
• checking whether a committed spec is stale;
• returning a read-only unified spec diff.

No changes to apiary are required. The integration uses its existing -out,
-check, and stdout output contracts.

Installation

go install github.com/dmedovich/openrun/cmd/openrun@v0.1.0
go install github.com/dmedovich/openrun/cmd/openrun-mcp@v0.1.0

GitHub release archives contain both binaries for Linux, macOS, and Windows on
amd64 and arm64.

Stability

This remains pre-1.0 software. The CLI, project configuration, MCP schemas, and
public Go API may evolve when changes improve correctness or simplify the
workflow. openrun intentionally validates the OpenAPI subset needed by the
runner rather than attempting to replace a full standards validator.