@slaveoftime/oly 0.0.4 → 0.0.5

package/README.md

@@ -0,0 +1,183 @@
+# oly — Open Relay
+
+<p align="center"><img src="./assets/icon-demo.svg" width="160" /></p>
+
+[![Watch the video](https://raw.githubusercontent.com/slaveoftime/open-relay/main/assets/oly-full-demo.png)](https://raw.githubusercontent.com/slaveoftime/open-relay/main/assets/oly-full-demo.mp4)
+
+<p align="center"><a href="./assets/oly-full-demo.mp4">Download or open the full demo video</a></p>
+
+[![npm version](https://img.shields.io/npm/v/@slaveoftime/oly.svg)](https://www.npmjs.com/package/@slaveoftime/oly)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+> Run any CLI like a managed service.
+
+`oly` turns long-running and interactive CLI workflows into persistent, supervised sessions for humans and AI agents. Close the terminal, keep the process alive, get notified when input is needed, and jump back in from anywhere.
+
+If this solves a real problem for you, give the repo a star so more people can find it.
+
+For a full repository architecture map, see [ARCHITECTURE.md](./ARCHITECTURE.md).
+For the PTY/session internals specifically, see [ARCHITECTURE_PTY.md](./ARCHITECTURE_PTY.md).
+
+---
+
+## The problem 😤
+
+You start an agent or interactive CLI 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 ⚡
+
+- Turns interactive CLIs into managed, auditable sessions
+- 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 send <id> key:enter`)
+- Keeps auditable logs of everything
+
+### Who it's for
+
+- People running AI coding agents that stall on prompts, permissions, or long-running work
+- Anyone using interactive CLIs that should survive terminal closes, disconnects, or context switches
+- Teams that want auditable logs and remote intervention instead of fragile ad-hoc shell sessions
+
+### Why not just `tmux`, `screen`, or a remote shell?
+
+| Need | `tmux` / `screen` | `oly` |
+|---|---|---|
+| Session survives after you close your terminal | Yes | Yes |
+| Detects when human input is likely needed | No | Yes |
+| Send input without attaching | No | Yes |
+| Built for supervising AI agents and interactive CLIs | Not really | Yes |
+| Keeps auditable session logs as a first-class feature | Minimal | Yes |
+
+### 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 📦
+
+```sh
+npm i @slaveoftime/oly -g
+```
+
+Global install is required because `oly` is a CLI. On first run, the npm package downloads the matching release binary for your platform.
+
+Currently supported via npm:
+
+- **macOS**: Apple Silicon (`arm64`)
+- **Linux**: x86_64 / AMD64
+- **Windows**: x86_64 / AMD64
+
+```sh
+brew tap slaveOftime/open-relay https://github.com/slaveOftime/open-relay
+brew install slaveOftime/open-relay/oly
+```
+
+```sh
+cargo install --path .
+```
+
+### Pre-built binaries
+
+Download the latest release for your platform from the [Releases page](https://github.com/Slaveoftime/open-relay/releases).
+
+- **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.
+
+---
+
+## Quick start 🚀
+
+The CLI is for both humans and AI agents.
+
+If you only try one workflow, make it this one: start the daemon, launch a session detached, inspect logs, then send input only when needed.
+
+```sh
+# 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 send <id> "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 a 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. 🔒
+
+---
+
+## Why star or watch this repo
+
+- You want a better way to supervise long-running agent or CLI sessions
+- You want release updates as packaging, remote supervision, and workflow support improve
+- You want to help shape an early tool in a fast-moving part of the developer tooling stack
+
+---
+
+## Commands 📋
+
+| Command | What it does |
+|---|---|
+| `oly daemon start` | Start background daemon |
+| `oly start [--detach] [--disable-notifications] [--cwd DIR] <cmd>` | Launch session in PTY |
+| `oly ls` | Show sessions (supports search/status/time filters) |
+| `oly attach <id>` | Reattach (replays buffer first) |
+| `oly logs <id> [--tail N] [--wait-for-prompt]` | Read logs without attaching |
+| `oly send <id> [CHUNK]...` | Send input without attaching |
+| `oly stop <id>` | Graceful stop |
+
+### Federation commands
+
+| Command | What it does |
+|---|---|
+| `oly api-key add <name>` | Create API key on primary (printed once) |
+| `oly api-key ls` | List API key labels on primary |
+| `oly api-key remove <name>` | Revoke API key on primary |
+| `oly join start --name <name> --key <key> <url>` | Connect this daemon as a secondary |
+| `oly join ls` | List saved join configs on this daemon |
+| `oly join stop --name <name>` | Disconnect and remove a saved join config |
+| `oly node ls` | List currently connected secondary nodes on primary |
+
+All session commands support `--node <name>` to target a connected secondary.
+
+Detach from an attached session: `Ctrl-]` then `d`.
+
+---
+
+## Code layout at a glance
+
+- `src/daemon/rpc.rs` keeps the top-level IPC dispatch, with attach handlers in `src/daemon/rpc_attach.rs` and federation/node runtime in `src/daemon/rpc_nodes.rs`.
+- `src/session/pty.rs` owns PTY resources and escape filtering, while `src/session/cursor_tracker.rs` and `src/session/mode_tracker.rs` track terminal state.
+- `src/client/join.rs` now focuses on join config persistence and CLI join commands; the secondary-node connector runs daemon-side.

package/bin/oly.js

@@ -10,7 +10,7 @@ const binaryPath = path.join(__dirname, binaryName);
 
 if (!fs.existsSync(binaryPath)) {
   console.error(
-    "oly: binary not found. Try reinstalling: npm install -g oly"
+    "oly: binary not found. Try reinstalling: npm install -g @slaveoftime/oly"
   );
   process.exit(1);
 }

package/package.json

@@ -1,19 +1,24 @@
 {
   "name": "@slaveoftime/oly",
-  "version": "0.0.4",
-  "description": "Session-persistent PTY daemon for long-running CLI agents — keep agents alive, get notified when they need input, intervene from anywhere.",
+  "version": "0.0.5",
+  "description": "Run interactive CLIs and AI agents like managed services with persistent PTY sessions.",
   "keywords": [
     "cli",
-    "agent",
     "pty",
-    "daemon",
-    "terminal"
+    "terminal",
+    "interactive-cli",
+    "ai-agents",
+    "automation",
+    "remote-control"
   ],
-  "homepage": "https://github.com/slaveOftime/open-relay",
+  "homepage": "https://github.com/slaveOftime/open-relay#readme",
   "repository": {
     "type": "git",
     "url": "https://github.com/slaveOftime/open-relay.git"
   },
+  "bugs": {
+    "url": "https://github.com/slaveOftime/open-relay/issues"
+  },
   "license": "MIT",
   "bin": {
     "oly": "./bin/oly.js"
@@ -21,6 +26,15 @@
   "scripts": {
     "postinstall": "node install.js"
   },
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
   "engines": {
     "node": ">=18"
   },