Install the Host
Run Oysterun on the same Mac or Linux user that already uses Claude Code or Codex.
For Claude Code and Codex
Control your computer's AI agents from your iPhone.
Oysterun connects your phone to Claude Code and Codex running on your own Mac or Linux machine. Start sessions, stop runaway work, approve tool calls, browse files, open HTML reports, and get notified when the agent needs you.
How it works
Four steps from Claude Code or Codex to phone control.
Claude Code and Codex still run on your computer. Oysterun gives your phone a secure control panel for that machine, so you can step away from the desk without losing the session.
Download app on phone
Install the iOS app before pairing so your phone can scan the Host login QR.
Download iOS appPair your iPhone
Run setup, scan the temporary Host QR, and your phone learns how to reach your computer.
Control the agent
Control the agent from phone or computer: Resume sessions, inspect reports/htmls, and receive notifications while the agent keeps working.
Architecture
Your data path is direct to your Host.
Oysterun does not route chat, files, websites, or agent messages through Oysterun Cloud. Your phone or browser talks directly to your Host. Cloud is used for notification delivery and the small registration metadata needed for push notifications.
Installation
Install the phone app, then install the Host.
Oysterun has two parts: the iOS app on your phone and the Host on the computer that runs Claude Code or Codex. Install the Host as the same computer user that runs Claude Code or Codex.
Linux Host
Create a dedicated user and install Oysterun into that user's npm prefix after Claude Code or Codex is installed and logged in for the same user.
sudo adduser oysterun
sudo usermod -aG sudo oysterun
su - oysterun
mkdir -p "$HOME/.local/npm"
npm config set prefix "$HOME/.local/npm"
printf '\nexport PATH="$HOME/.local/npm/bin:$PATH"\n' >> "$HOME/.profile"
. "$HOME/.profile"
# Install and log in to Claude Code or Codex as this user first.
command -v claude || command -v codex
npm install -g oysterun@latest --prefer-online
oysterun --version
oysterun setup
oysterunNode.js 20 or newer is required.
macOS Host
With Node.js 20 or newer available, install the Host package after Claude Code or Codex is installed and logged in, then run the guided setup.
# Install and log in to Claude Code or Codex as this user first.
command -v claude || command -v codex
npm install -g oysterun@latest --prefer-online
oysterun --version
oysterun setup
oysterunThe Host starts locally and prints a phone login QR.
Updates
Keep the Host current
Use the same computer user that runs Oysterun. This installs the current public Host package, restarts the Host, and keeps your existing setup.
npm install -g oysterun@latest --prefer-online
oysterun --version
oysterun service:restart
oysterun service:statusFeatures
Controls that make remote agent work practical.
Fully open source
Inspect, fork, and adapt the Host and mobile control layer for your own workflow.
Keep the session moving
Resume, stop, pin, search, and loop Claude Code or Codex sessions from your iPhone.
Run recurring work
Schedule jobs like: every morning, send me a Tesla stock report.
File Preview / Website
Open generated HTML and Markdown reports, or publish richer outputs as agent-built websites.
Browse local files
Explore folders, inspect project files, and find outputs created by Claude Code or Codex.
Stop babysitting the terminal
AI agents should not require you to babysit a terminal. Get notified when work finishes, blocks, errors, or needs your approval.
FAQ
The first questions people ask when they see Oysterun.
What is a Host?
The Host is the machine running the Oysterun Host and Agent Framework, acting as a bridge between the phone client and the agent provider. Oysterun Host connects your phone to Claude Code, Codex, local files, sessions, websites, and notifications on that machine.
Is Oysterun an AI model?
No. Oysterun is the phone app and Host layer around Claude Code and Codex.
Does my agent run on Oysterun's server?
No. Your agent runs on your own computer. Oysterun gives your iPhone a way to control and inspect that local Host.
Does Oysterun store my conversations?
No. Normal agent conversations and files live on your own machine. Oysterun Cloud is limited to pairing support, notifications, identity, and operational security.
Who is this for?
People who already use coding agents, and anyone who wants useful AI work to continue on their computer while they manage it from their phone.
What agent providers are supported now?
Oysterun currently supports Codex and Claude Code. We plan to evaluate additional agent ecosystems in the future.
Why not just use SSH or Telegram?
SSH and Telegram are useful pipes, but Oysterun adds product surfaces around the work: scheduler, Explorer, File Preview, notifications, search, pinned messages, session management, and agent-published websites.
How long can a session run?
Long-running work is a core use case. In June 2026, I traveled in Europe for a month while my Oysterun Host in Taiwan kept working on this project around the clock. By July 5, 2026, the same project had been running through Oysterun for more than three months.
How do HTML reports work?
You can preview a single HTML file through File Preview. For richer output, every agent can also publish a website under its site folder, and that site can be shared with others with or without a password.
What if I do not have a public IP?
Use Tailscale for now; its free tier is usually enough for a single user. We also plan to provide an Oysterun Tunnel Service in the future.
Why not just use Claude Mobile?
Claude Mobile is useful, but today it does not provide Oysterun's file explorer, agent websites, scheduler, session management, or Host-level workflow controls. Those surfaces are what make it practical to run a full project from a phone. Claude Mobile may add more features over time; Oysterun is focused on the local Host workflow.
Coming soon
The roadmap keeps the same promise: more power, less lock-in.
AgentHub
Share agents with one click and install community-built agents instantly.
Tunnel Service
Access your home computer without a public IP through a secure Oysterun Cloud bridge.
Android
Bring the mobile agent control surface to native Android devices.
Future agent support
Evaluate more AI frameworks, providers, and agent ecosystems for future support.
Start with the phone app
Make your existing agents full-functioned from your iPhone.
Install the app, run the Host on your computer, scan the QR code, and keep your agent session with you.