Skip to content

v0.5.0

Latest

Choose a tag to compare

@github-actions github-actions released this 28 Oct 03:02
· 5 commits to main since this release

oly 0.5.0

The first stable 0.5 release. Close your laptop; the daemon keeps your
sessions running. Come back from a terminal, a browser, or your phone.

GitHub release
· What's new in 0.5
· Upgrade from 0.3
· Compatibility

Highlights

  • Your work outlives your terminal. The daemon owns the PTY, records output,
    and keeps the child running when a client disconnects.
  • One place to see what needs you. The terminal dashboard and the
    password-protected web UI show lifecycle state and agent-reported program
    status (OSC 7501) across local and connected machines.
  • Check in without taking over. Read rendered output, inspect a live screen,
    wait for a likely prompt, then send text, keys, or mouse input — or attach.
  • Scriptable supervision. oly info --json, bounded byte pages, and
    resumable cursors let agents and scripts follow sessions safely.
  • Built to be operated. Readiness and health endpoints, disk-capacity
    visibility, honest failure reporting, and four shipped platforms.
  • Works on the devices you carry. The PWA fits above the Android soft
    keyboard, keeps the cursor visible, and avoids duplicated IME input.

What's new since 0.3

0.5 is a substantial redesign: journal-backed recording, one authoritative
terminal model, the unified oly node federation CLI, and a session list that
stays responsive with thousands of sessions. See
What's new in 0.5 for the tour and
Compatibility for 0.5 for the supported contracts.

Upgrade from 0.3 — read this first

0.5 is a breaking upgrade. Finish live work, stop the daemon, back up the whole
state directory, and keep the old binary.

  • Recordings are not imported. Keep the old binary if you still need 0.3 logs.
  • Protocol 15. Upgrade the CLI, the daemon, and every federation node together.
  • Node management is unified. oly join and oly node accept are removed,
    and the SQLite migration drops legacy authorizations. Re-provision both peers
    with verified keys.
  • Log flags and recording-cap config keys changed. Update scripts and config;
    removed keys now fail startup explicitly.
  • Linux default IPC is scoped. Stop the old daemon with the old binary before
    replacing it, or set OLY_SOCKET_NAME explicitly.
  • Custom apps and proxies stay opt-in. Review code before enabling them.

Follow Migration to 0.5 for the exact actions, not just
the highlights.

Install

npm install -g @slaveoftime/oly
oly --version

Homebrew (macOS Apple Silicon, Linux x64):

brew tap slaveOftime/open-relay https://github.com/slaveOftime/open-relay
brew install slaveOftime/open-relay/oly

Cargo:

cargo install oly

Prebuilt archives: Linux x64, Linux arm64, macOS Apple Silicon, and
Windows x64, with SHA-256 checksums on the GitHub release.

Known limits

  • Daemon stop/crash or reboot ends live processes; recordings are not PTY recovery.
  • Prompt/idle signals and successful input delivery are not proof of completion.
  • Program status is app-reported state, not process status and not approval.
  • Controllers share input and geometry; coordinate with other users.
  • No live recording quota is implemented; use OS quotas and independent backups.
    The admission guard is not a quota and never kills an existing session.
  • Federation has no forward secrecy and no supported mixed-version rollout.
  • Custom apps share the control-plane origin; they are not sandboxed.

See Compatibility for 0.5 for the 0.5 contract.

Verification

This section records what was observed for this release.

  • Release commit: tag v0.5.0 on release-prep commit 1b465b0.
  • Pre-tag documents contract: python3 tests/docs_sync.py passed (9/9) on the
    release-prep tree. tests/release_workflow.py requires a POSIX host and runs
    in CI-DOCS.
  • Release workflow
    (run 40623272928):
    all four build-release jobs, attach SHA256SUMS,
    update-homebrew-formula, publish-npm, and publish-crates succeeded.
  • npm: latest moved to 0.5.0; beta stayed at 0.5.0-beta.3.
  • crates.io: 0.5.0 is published and is the current newest version.
  • Homebrew: Formula/oly.rb on main is at 0.5.0 with updated macOS arm64
    and Linux x64 checksums (commit 71ae07e).
  • GitHub release: carries the four platform archives, their per-asset
    .sha256 sidecars, and the aggregated SHA256SUMS.txt.
  • Checksums: SHA256SUMS.txt matches the Homebrew formula for macOS arm64 and
    Linux x64. Archive re-download verification was not completed on the
    release-prep machine.

Manual checks — maintainer-reported

None recorded. Physical-device checks (real Windows sleep/resume, mobile and
browser access) are the maintainer's report, not a CI result, and are not
claimed here.