oly 0.0.3

oly — Open Relay

<p align="center"><img src="./assets/icon-demo.svg" width="160" /></p>

Run agents. Walk away. Intervene when it matters.

oly is a session-persistent PTY daemon for long-running CLI agents (Claude Code, Gemini CLI, OpenCode, normal CLI etc.). It keeps your agent alive after you close the terminal, notifies you when something needs a human, and lets you intervene from anywhere.

For a full repository architecture map, see ARCHITECTURE.md.

The problem 😤

You start an agent task. It runs for 20 minutes. Halfway through it hits a y/n prompt and just... sits there. You had to keep a terminal open, stay at your desk, babysit it.

That's over.

What oly does ⚡

• Owns agent sessions in a background daemon — closing your terminal changes nothing
• Replays buffered output when you reattach (no lost context)
• Detects when input is likely needed and notifies you
• Lets you inject input without attaching (oly input <id> --key enter)
• Keeps auditable logs of everything

Agent-supervises-agent 🤖 👀 🤖

You can run one agent to supervise another. When the supervisor hits something it's unsure about — or something that needs elevated permission — it escalates to you. You decide whether to approve, modify, or abort. You're still in the loop, just not watching.

Install 📦

Pre-built Binaries

Download the latest release for your platform from the Releases page.

• macOS: Download oly-macos-arm64.zip, unzip, chmod +x oly, and move to /usr/local/bin.
• Linux: Download oly-linux-amd64.zip, unzip, chmod +x oly, and move to /usr/local/bin.
• Windows: Download oly-windows-amd64.zip, unzip, and add to your PATH.

From Source

cargo install --path .

Quick start 🚀

The cli is both for human and AI agent.

# Start the daemon (once per boot, or add to your init)
oly daemon start

# Launch an agent session and detach immediately
oly start --title "code is cheap" --detach copilot

# Check what's running
oly ls

# Peek at output without attaching
oly logs <id>

# Something needs your input — send it without a terminal
oly input <id> --text "yes" --key enter

# Actually attach and drive it yourself
# Ctrl+D to detach anytime
oly attach <id>

# Stop it when done
oly stop <id>

Remote supervision 🌐

Access and manage sessions from browser, with push notification support. Intervene from anywhere.

oly has no built-in network listener — deliberately. Expose it the way you control:

[anywhere] → [your auth gateway] → [tunnel] → [oly daemon, local IPC]

Put Cloudflare Access, Tailscale, or any auth proxy in front. Every action logged. Your rules. 🔒

Commands 📋

Federation commands

All session commands support --node <name> to target a connected secondary.

Detach from an attached session: Ctrl-] then d.