Mockingo Agent v0.4.0

Mockingo Agent v0.4.0

New commands

• mockingo run starts the public tunnel and dependency capture/replay proxy
  with the same options, defaults, child-process support, and behavior as
  mockingo expose.
• mockingo version prints the CLI version without requiring login or
  configuration. These release binaries report v0.4.0.
• CLI help and usage examples now use mockingo run.

Deprecation and migration

mockingo expose is deprecated. It continues to work as an alias for
mockingo run and prints a deprecation warning to stderr. Update scripts
and terminal commands by replacing expose with run; existing flags and
child-command arguments remain valid.

mockingo run --name my-api --http 8080
mockingo version

Dependency capture and replay remain enabled by default. Use
--dependency-proxy=false to opt out. Authentication, credential storage,
and tunnel protocol version 1 are unchanged.

Downloads

Platform	Artifact
Windows x64	mockingo-windows-amd64.exe
Linux x64	mockingo-linux-amd64.tar.gz
Linux ARM64	mockingo-linux-arm64.tar.gz
macOS Intel	mockingo-darwin-amd64.tar.gz
macOS Apple Silicon	mockingo-darwin-arm64.tar.gz

Each archive contains an executable named mockingo with executable
permissions. Uncompressed Linux and macOS binaries are also available in
their platform subfolders. SHA256SUMS covers the five download artifacts.

Build and validation

• Source: tag v0.4.0, commit 86d9a2512e1e13a9b0231d844bfaf69e7f5fd306.
• Built with Go 1.26.5, CGO_ENABLED=0, -trimpath, and the embedded CLI
  version set to v0.4.0. Workspace mode was disabled to use this
  repository's declared dependencies.
• All five platform builds, go test ./..., and go vet ./... passed.
• The Windows binary's version output and command help were checked locally.
  Linux and macOS binaries were cross-compiled; they were not executed locally.
• Archive contents, executable permissions, and SHA-256 checksums were verified.
• Race tests were not run because this environment lacks a C compiler.

Mockingo Agent v0.3.1

Mockingo Agent v0.3.1

Windows login

This patch updates automatic browser opening for mockingo login on Windows.
It addresses reports of the OAuth callback changing from 127.0.0.1 to
localhost during automatic browser opening, followed by Clerk rejecting
consent with a redirect_uri mismatch. Pasting the original CLI URL into the
browser was a workaround for the reported issue.

• Replaces the rundll32 / url.dll launcher with the Windows
  ShellExecuteW API, passing the complete authorization URL directly to the
  default browser handler.
• Preserves the encoded OAuth parameters at the Windows API boundary,
  including redirect_uri, PKCE challenge, state, and nonce.
• Initializes COM on the launcher's OS thread for browser handlers that need it.
• Reports launcher failures through the existing manual-URL fallback.
• Adds Windows regression tests for URL preservation, launcher failures, and
  embedded-NUL rejection, plus Windows authentication checks in CI.

Compatibility

• The default callback remains http://127.0.0.1:53682/oauth/callback.
• OAuth scopes, credential storage, and tunnel protocol version 1 are unchanged.
• Linux and macOS retain their existing browser launchers.
• If automatic browser opening still fails, use
  mockingo login --force --no-browser and paste the printed URL into a browser.

Downloads

Platform	Artifact
Windows x64	mockingo-windows-amd64.exe
Linux x64	mockingo-linux-amd64.tar.gz
Linux ARM64	mockingo-linux-arm64.tar.gz
macOS Intel	mockingo-darwin-amd64.tar.gz
macOS Apple Silicon	mockingo-darwin-arm64.tar.gz

Each archive contains an executable named mockingo. Use SHA256SUMS to
verify the five download artifacts.

Build and validation

• Source: tag v0.3.1, commit 849cf0ae4c4e772a97eaad4aa180c9a9795a9eda.
• Built with Go 1.26.5, CGO_ENABLED=0, and -trimpath, with workspace mode
  disabled so builds use this repository's declared dependencies.
• All five platform builds, go test ./..., and go vet ./... passed.
• Automated URL-preservation tests cover the Windows API boundary. Confirmation
  of the reported intermittent browser behavior still requires testing on an
  affected PC.

Mockingo Agent v0.3.0

Mockingo Agent v0.3.0

Highlights

This release makes the dependency capture and replay proxy accessible to
applications running in Docker or on another trusted development host.

• mockingo expose now accepts --proxy-bind <ip> to select the dependency
  proxy listener address. The default remains the loopback-only
  127.0.0.1.
• Use --proxy-bind 0.0.0.0 when a Docker Desktop container must reach the
  proxy through host.docker.internal. Native Linux Docker may additionally
  require a host-gateway mapping.
• Startup output now distinguishes the listener address from the proxy URLs
  intended for host applications and Docker Desktop containers.
• A prominent warning is printed whenever the proxy listens outside localhost.
• Invalid bind addresses and listener failures are reported before the public
  tunnel starts, with guidance for choosing another port or disabling the
  dependency proxy.

Security and behavior

• Loopback-only binding remains the secure default.
• --proxy-bind accepts an IP address, not a hostname. Non-loopback listeners
  should be used only on trusted development networks because any reachable
  client may be able to use the proxy.
• Mockingo does not change Docker networking, proxy environment variables,
  operating-system proxy settings, or trust stores. HTTPS clients must still
  trust the printed public Capture CA certificate manually; never distribute
  the private CA key.
• Dependency capture and replay continue to share the mockingo expose
  lifecycle and can be disabled with --dependency-proxy=false.

Compatibility

• The tunnel protocol remains at version 1.
• Existing loopback-based workflows continue to use 127.0.0.1:8899 without
  configuration changes.
• Binaries are provided for Windows amd64, Linux amd64 and arm64, and macOS
  amd64 and arm64.

Use the accompanying SHA256SUMS file to verify downloaded artifacts.

Mockingo Agent v0.2.0

Mockingo Agent v0.2.0

Highlights

This release adds dependency capture and replay to the Mockingo Agent workflow.

• mockingo expose now starts a loopback-only dependency HTTP/S proxy on
  127.0.0.1:8899 by default, alongside the public tunnel.
• Captured dependency interactions are uploaded through a dedicated,
  authenticated gateway session without changing operating-system proxy or
  trust-store settings.
• Cloud-configured dependency replays are delivered to the agent and matched
  locally before an origin connection is attempted.
• HTTPS inspection uses a locally generated CA certificate. Exact hosts can be
  excluded from inspection with repeatable --passthrough-host options.
• Use --dependency-proxy=false to run mockingo expose without dependency
  capture and replay. The standalone mockingo capture --name <endpoint>
  command remains available for dependency-only workflows.

Security and behavior

• The dependency proxy listens only on loopback and does not modify application
  environment variables, operating-system proxy settings, or trust stores.
• Public-tunnel and dependency-capture tickets are separate, short-lived,
  one-use credentials. They are not persisted or logged.
• Capture upload failures do not interrupt proxy forwarding. Replay matches are
  served locally; unmatched requests continue to their configured origin.

Compatibility

• The tunnel protocol remains at version 1.
• Existing Local and Virtual endpoint behavior is unchanged.
• Dependency capture and replay can be disabled without changing the existing
  public-tunnel workflow.

Downloads

Binaries are available for:

• Windows amd64
• Linux amd64 and arm64
• macOS amd64 and arm64

Use the accompanying SHA256SUMS file to verify downloaded artifacts.

Mockingo Agent v0.1.0

Mockingo Agent v0.1.0

Highlights

This release adds support for the cloud-managed Virtual endpoint lifecycle while keeping mock execution outside the CLI.

• mockingo expose now reports an actionable error when the selected endpoint is configured with a Virtual origin, directing the user to switch it to Local before connecting the agent.
• If a connected Local endpoint is switched to Virtual, the agent now ends the expose session cleanly when the gateway sends the endpoint_virtualized disconnect reason.
• Endpoint virtualization does not enter the automatic reconnect loop. Reconnect behavior for other transient disconnections is unchanged.

Compatibility

• The tunnel protocol remains at version 1.
• Existing Local endpoint workflows and CLI commands remain unchanged.
• There is no --virtual CLI option; Virtual endpoint configuration and mock execution remain cloud-managed.

Downloads

Binaries are available for:

• Windows amd64
• Linux amd64 and arm64
• macOS amd64 and arm64

Use the accompanying SHA256SUMS file to verify downloaded artifacts.

Mockingo Agent v0.0.1

Mockingo Agent v0.0.1

Initial public release of the Mockingo CLI and local tunnel agent.

Mockingo Agent securely exposes a local HTTP application through a public
Mockingo endpoint.

Quick start

1. Download the appropriate file for your platform.
2. Install or extract the mockingo executable.
3. Sign in and expose your application:

mockingo login
mockingo expose --name my-app --http 8080

Downloads

• mockingo-windows-amd64.exe — Windows x86-64
• mockingo-linux-amd64.tar.gz — Linux x86-64
• mockingo-linux-arm64.tar.gz — Linux ARM64
• mockingo-darwin-amd64.tar.gz — macOS Intel
• mockingo-darwin-arm64.tar.gz — macOS Apple Silicon
• SHA256SUMS — SHA-256 checksums

Verify downloads

Linux:

sha256sum --check SHA256SUMS --ignore-missing

macOS:

shasum -a 256 --check SHA256SUMS

Notes

• Windows and macOS binaries are currently unsigned.
• macOS users may need to approve the binary in Privacy & Security settings.
• Protocol v1 supports HTTP request and response forwarding with a 10 MiB body
  limit.