Terminay Files

This release migrates Terminay's development process to OpenSpec, a spec-driven methodology, while shipping several user-facing improvements to the terminal workspace, documentation features, and activity tracking.

Spec-Driven Development Migration

OpenSpec Framework

Migrated the entire project specification system from a flat task structure to OpenSpec, a comprehensive spec-driven development framework with architectural decision records (ADRs), feature specifications, and change proposals. The new structure organizes work around 24 core feature specs and enables agent-assisted development through reusable skills.

Documentation and Tooling

Established OpenSpec configuration, schema templates, and agent skills for spec exploration, proposal, application, and synchronization. Moved operations documentation to docs/operations/ and created comprehensive ADR evidence files documenting architectural decisions around runtime baselines, state repositories, security models, and WebRTC transport.

Terminal Workspace and Mobile Improvements

Navigation and Input Handling

Fixed the narrow navigation drawer to overlay as a full-size drawer on mobile viewports with opaque background rendering. Corrected terminal software keyboard focus to activate on tap rather than scroll, preventing unintended keyboard dismissal during inertial scrolling. Eliminated NaN SGR mouse reports from touch inertia calculations.

Project Tab Enhancements

Each new project tab now receives a distinct color assigned randomly on creation, with seeded default projects holding the first number. Default project names are guaranteed unique within the workspace. Activity badges now display as circular count indicators per project tab, with settle-before-finished semantics ensuring badges reflect stable terminal state.

Documentation and MDX Features

Documentation Sidebar and Editor

Introduced a Documentation catalog sidebar pane with MDXEditor integration for browsing and editing project documentation files. The catalog auto-populates from .md and .mdx files, respects .gitignore patterns, and defers cataloging until the pane is explicitly opened to avoid launch overhead.

MDX Preview Runtime

Implemented sandboxed MDX compilation and preview runtime with blob-backed storage, iframe mounting persistence during compile cycles, and file explorer integration for previewing MDX files directly. Added type safety for preview iframes and download abort handling.

Extension and Agent Improvements

Agent Extension API

Shipped the agent-provider authoring surface and test harness, enabling developers to create custom agent extensions. Built-in agent extensions (Codex, Cursor, OMP) now integrate with the extension platform, with provider-scoped Browse Terminay VMs feature in Puzed for environment selection.

Remote Authentication

Implemented end-to-end WebRTC authentication before SDP exchange in Desktop connections, with optional timestamp validation on bootstrapped WebRTC auth. Fixed terminal checkpoint catch-up derivation from lane limits to improve stream position authority.

Dependency and Infrastructure Updates

Production Audit Fix

Overrode fast-uri to version 4.1.4 to clear production security audit findings.

Release Assets

• macOS installer: https://github.com/markwylde/terminay/releases/download/v3.14.0/Terminay-Mac-3.14.0-Installer.dmg
• Linux AppImage: https://github.com/markwylde/terminay/releases/download/v3.14.0/Terminay-Linux-3.14.0.AppImage
• Standalone server: https://github.com/markwylde/terminay/releases/download/v3.14.0/terminay-server-3.14.0.tgz