oly — Open Relay

Your agents keep running. You stay in control.

Run an interactive CLI once. Close your terminal. Come back from another terminal or a browser — with the process still running and its output recorded.

oly is a local-first session supervisor for coding agents, REPLs, and long-running commands that still need a human in the loop. It works with the CLI you already use; no model-provider integration required.

https://github.com/user-attachments/assets/bd52a474-d9c4-48a7-824b-8df328a9d5a7

Why oly?

• Walk away without losing the job. The daemon owns the PTY, not your terminal.
• Check in, don't babysit. Read recent output, inspect a live TUI, or wait for a likely input-needed checkpoint.
• Intervene without attaching. Send text, keys, or application mouse input; take over interactively when needed.
• Pick up from anywhere. Use the terminal or browser, and route work to connected machines.
• Give agents a reliable control surface. JSON metadata, bounded byte pages, and resumable cursors support scripted supervision.

Think persistent terminal sessions + a supervision API, not another agent framework. Use your shell for quick commands; use oly when a job needs a durable home.

Install

npm install -g @slaveoftime/oly

The npm package bundles binaries for Linux x64, macOS Apple Silicon, and Windows x64. No GitHub asset download is needed during installation.

0.5.0-beta.1 is available: a breaking preview, not the stable channel. Stable installs still use the 0.3 line. Try npm install -g @slaveoftime/oly@beta or the GitHub prerelease. Back up state and read the migration guide before upgrading. See the release notes and verification.

Other installation options

Homebrew (stable):

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

Prebuilt binaries: download a platform archive from GitHub Releases.

Cargo (stable):

cargo install oly

Building from source requires Rust and Node.js/npm: release builds compile and embed the web UI. See Contributing for development setup.

From launch to handoff

# Start the daemon (skip this if it is already running).
# Default: password-protected web UI at http://127.0.0.1:15443.
oly daemon start --detach

# Run your preferred CLI in the background; save the returned session ID.
oly start --detach --title "fix failing tests" copilot

# See sessions and inspect recent output.
oly ls
oly logs <id> --tail 40

# Inspect a TUI and, after reviewing its prompt, reply without attaching.
oly logs <id> --screen
oly send <id> "continue" key:enter

# Take over interactively. Ctrl-D detaches; the child keeps running.
oly attach <id>

Replace copilot with claude, codex, another agent, or any interactive command. Pass oly options before the child command.

Open http://127.0.0.1:15443 for the browser UI, or use oly ls --follow for the live terminal dashboard.

A few commands worth remembering