Install the Host
Run Oysterun on the same Mac or Linux user that already uses Claude Code, Codex, or your agent runtime.
For Claude Code, Codex, and local agents
Control your computer's AI agents from your iPhone.
Oysterun connects your phone to the agents 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 local agent to phone control.
Your agent still runs 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.
What you can do from the phone
All the small controls that make remote agent work practical.
Continue a session
Reply to Claude Code, Codex, or another agent without opening your laptop.
Interrupt bad work
Typed the wrong instruction or saw the agent going in circles? Stop it from your phone.
Serve agent built websites
Publish agent produced sites, access in the general browser, and share with others with various permissions.
Browse local files
Explore your computer's file system from Oysterun, open folders, inspect agent outputs, and find the files created during a session.
View reports and code files
Agents are good at generating MD/HTML. Oysterun makes those reports easy to open on iPhone, and lets you preview code files, logs, and other outputs in place.
Know when to return
Get notified when work finishes, blocks, errors, or scheduled jobs need attention.
A normal day with Oysterun
Start work at your desk. Finish decisions from your phone.
You ask Codex to build a report. Then you leave your desk. The agent keeps running on your computer, Oysterun notifies you when it needs a decision, and the finished HTML report opens on your iPhone.
- DeskStart an agent session on your computer.
- PhoneLeave the desk and watch progress from Oysterun.
- AlertApprove a tool call or stop the agent if the task changed.
- OutputOpen the generated file or HTML report on iPhone.
Built for agents, not just humans
Agents can use Oysterun too.
Oysterun tools are designed to be operated by people and by agents. An agent can search prior context, access files, publish a website, schedule jobs, send notifications, and inspect outputs.
Ask once
Generate a daily sales report every morning at 9 AM and notify me when it is finished.
- 08:00Agent starts automatically
- 08:03Collects data and checks context
- 08:08Writes the report
- 08:10Publishes the HTML page
- 08:11Sends a phone notification
The product surfaces
Not a new AI model. A control layer for the agents you already use.
Why Oysterun exists
AI agents should not require you to babysit a terminal.
Today's agents are powerful, but the working loop is still built around developer habits: terminals, SSH, cloud dashboards, scattered files, long-running jobs, and no simple way to know when the agent needs you.
Oysterun exists to make agents feel like something you can live with: running on your own computer, close to your files and tools, but reachable from the phone you already carry.
Let the agent keep working while you leave the desk.
Open sessions, files, reports, and schedules from one mobile surface.
Keep the agent runtime on your computer instead of moving the work elsewhere.
Why local-first matters
Your agent still belongs to your computer.
Oysterun is not trying to move your agent into a central cloud. Your conversations, files, tools, and runtime stay on your Host. Oysterun Cloud is limited to pairing support, identity, notifications, and operational security.
Runtime
Bring your agent
Use Claude Code, Codex, or the local agent workflow you already trust.
Machine
Use your computer
The Host runs on your Mac or Linux machine, close to your files and tools.
Control
Keep the decision loop
Your phone gives you the review, stop, inspect, and notification layer.
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.
Fully open source
No black box between your phone and your agent.
Oysterun is built to be inspected, modified, and adapted. Read the code, change the Host, build your own tools, and keep your agent workflow under your control.
Inspect how agent control works
Fork it for your own workflow
Keep using your own models and tools
Run without subscription lock-in
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 your agents. Install the Host as the same computer user that runs Claude Code, Codex, or your agent runtime.
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:statusComing 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.
More agents
Support more AI frameworks, providers, and agent ecosystems such as Hermes or OpenClaw.
FAQ
The first questions people ask when they see Oysterun.
Is Oysterun an AI model?
No. Oysterun is the phone app and Host layer around the agents you already run, such as Claude Code, Codex, or your own local workflow.
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 such as Hermes and OpenClaw.
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.
Start with the phone app
Make your existing agents reachable from your iPhone.
Install the app, run the Host on your computer, scan the QR code, and keep your agent session with you.