ENGINEERING EXECUTION CONTROL PLANE

ExecRelay Terminal

Run anything. Trace everything. Verify what actually happened.

A local-first engineering terminal for capturing execution evidence, observing repository changes, and explicitly verifying engineering work.

Status
v0.2.0 · Public Release · macOS / Windows / Linux
Validation
macOS arm64 · Developer ID · Notarized · Runtime validated
Public Release Commit
531fb9d · GitHub public projection
Binary Provenance
e71e5b1 · Frozen private source
Architecture
Local-first · Standalone native packages
PACKAGES

Downloads

Official release binaries built from the binary provenance commit. macOS is Developer ID signed and notarized; Windows and Linux packages are accompanied by authoritative SHA-256 checksums.

TESTING EVIDENCE

Platform Validation

Testing coverage and validation status recorded for the v0.2.0 release artifacts.

macOS Apple Silicon (arm64)

Validated

Signed with Developer ID Application (Xingchi Guo (HLLU3R6CC3)), Hardened Runtime enabled, notarized by Apple, and stapled. Conforms to Gatekeeper requirements (spctl source=Notarized Developer ID). Fully verified via isolated manual-assisted runtime validation and v0.1.2 → v0.2.0 upgrade state preservation without fabricating child processes, PTYs, sessions, or commands from restored metadata.

Windows (x64 & ARM64)

Build-Tested

Packaged as NSIS installers for x64 and ARM64. Built on Windows runners; x64 installer verified through automated CI install, launch, and uninstall smoke routines. Installers are currently unsigned (Windows Defender SmartScreen may display an “Unknown publisher” notice). Real-desktop interactive validation is not claimed for this release.

Linux (x64 .deb & AppImage)

Container-Tested

Built as standalone .deb and .AppImage packages for x64. Verified in clean Ubuntu 22.04 container environments under an Xvfb virtual display for package installation, desktop entry execution, PTY terminal execution, and process reaping on close. Packages are currently unsigned; integrity should be checked against SHA256SUMS.txt. Real-desktop window-manager validation is not claimed for this release.

TECHNICAL BOUNDARIES

Known Limitations

Documented architectural caveats and deferred platform items for v0.2.0.

VERIFY-SHELL-001

Windows Shell Policy

Verification criteria execution requires a POSIX shell or supported runner. Native shell policy interceptors are POSIX/zsh/bash focused; Verify checks do not operate within Windows PowerShell sessions.

WINDOWS-BINARY-NAME-001

Process Details

The Windows executable remains named tracerelay.exe inside %LOCALAPPDATA%\ExecRelay (visible in Task Manager process details and pin targets). User-facing shortcuts, directories, and window chrome display ExecRelay.

WORKSPACE-ROOT-REBIND-001

Cross-Platform Paths

Unreachable local directories or foreign cross-platform workspace paths restore in an unbound state, surfacing an explicit unavailable notice rather than silently mutating paths or creating shells in fallback folders.

Unsigned Installers & Packages

Security Prompts

Windows NSIS installers and Linux packages are unsigned for this release. Verify package checksums against the official SHA256SUMS.txt file before installation.

SURFACES

Core Features

Four integrated surfaces designed for transparent, verified engineering execution.

Terminal

Real PTY-backed engineering terminal for everyday command-line workflows, split panes, and interactive tools.

Capture

Structured evidence for executed commands and observed outcomes, preserving raw process truth without inferring success from terminal text.

Changes

Repository changes observed during execution windows, tracking file modifications alongside process runs via read-only Git collectors.

Verify

Explicit verification checks with retained run history, deterministic criteria evaluations, and monorepo working directory support.

SETUP

Installation on macOS

  1. 1
    Download: Download the ExecRelay-v0.2.0-macos-arm64.dmg disk image.
  2. 2
    Open: Double-click the downloaded DMG file to mount it in Finder.
  3. 3
    Install: Drag the ExecRelay application into your Applications folder.
  4. 4
    Launch: Open ExecRelay from Applications or Spotlight.
SPECIFICATIONS

System Requirements

Operating System macOS 11.0+ · Windows 10/11 · Ubuntu 22.04+
Architecture Apple Silicon (arm64 validated) · x64 · Windows ARM64
Runtime Engine Native Rust / Tauri v2
Account Requirement None (local-first)
ARCHITECTURE

Security & Trust Model

Process Truth: ExecRelay establishes ground truth from native process supervisory outcomes and explicit verification checks rather than guessing success from terminal text or AI-generated prose. Exit codes and structured execution records remain the authoritative source of truth.
Privacy by Design: ExecRelay requires no account or cloud connection. Execution, transcripts, and repository snapshots remain strictly on your local machine unless a command you run explicitly transmits them. Terminal operation survives even if telemetry fails.