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.
Install Host on computer
Open iPhone app
Scan QR code
Control the agent
How it works
Two installs. One remote control surface.
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.
Pair your iPhone
Open the iOS app and scan the QR code printed by the Host. Your phone now knows how to reach your computer.
Use the agent remotely
Resume sessions, approve actions, inspect outputs, 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.
Handle tool decisions
Review actions when an agent needs permission, then approve or reject without returning to your desk.
Inspect outputs
Browse your computer's folders and open the files your agent just created.
Open HTML reports
Agents are good at generating HTML. Oysterun makes those reports easy to open on iPhone.
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.
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.
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:statusFAQ
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.
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.