Understand how Oysterun reaches your Host.

How it works

Oysterun runs a Host beside a supported Codex, Claude Code, or Grok provider for the same operating-system user. The phone client and an ordinary website browser are two ways to reach that one Host identity; they open the same Session state instead of creating separate Hosts.

Architecture

After a Client reaches the Host, Chat, Explorer and file access, websites, and Session control use the direct Client-to-Host path.

Oysterun Cloud separately supports bounded Host registration and notification delivery. Whether those support paths are used depends on the configured feature; they are distinct from direct product traffic.

Install Oysterun Host

Prerequisites: Ubuntu 22.04+ with Bash, or macOS with Bash or zsh. Download requires curl. On Ubuntu, direct root can run apt-get update && apt-get install -y curl; an ordinary administrator can run sudo apt-get update && sudo apt-get install -y curl. macOS normally includes /usr/bin/curl; if it is missing, stop and restore it through macOS Software Update or Apple Support. Use administrator access only for these bounded prerequisites or when the installer explicitly requests it.

The installer downloads and checksum-verifies an Oysterun-managed Node.js 22 runtime. It does not require Homebrew or alter Ubuntu package repositories for Node.js.

curl -fsSL https://oysterun.com/install.sh | bash

The same installer selects the correct platform path and opens guided setup.

Open the complete install and connection steps

Features

The current product surface includes Sessions, Chat, Explorer, File Preview, websites, Scheduler, Mail, notifications, search, and Host lifecycle controls. A particular provider or Host configuration may expose only the surfaces it supports.

Current maturity and roadmap

Oysterun is currently distributed as Beta software. The documentation records behavior verified today; it does not turn unshipped work or a roadmap date into a delivery promise.