OK Remote

Code and stuff from your phone.

OK Remote pairs your phone with a coding agent running on your own computer. Your agent works while you're AFK.

curl -fsSL https://ok.lol/install.sh | sh
Download on the App Store
The checkout auth test flakes ~1 run in 5. Find and fix it.
Shell done
$ bun test src/checkout --rerun 20
17 pass 3 fail (24.8s)
src/checkout/auth.test.ts +6 -2
44 const token = await session.token();
45 - await sleep(50);
45 + await waitFor(() => session.fresh);
Shell done
$ bun test src/checkout --rerun 50
50 pass 0 fail (61.2s)
It raced the token refresh. Now it waits for it — 50 runs, no flakes.

It's ok to walk away.

Agent runs take minutes, sometimes hours. None of that time requires you to be watching. Start a task at your desk, steer it from the couch, check the diff from the dog park. Your computer notifies you when the agent finishes or needs a decision.

Tuesday, August 18
3:57
Fix flaky checkout auth
It raced the token refresh. Fixed — 50 runs, no flakes. PR is up.
now
Refactor billing
Two ways to split the invoice model. Want the adapter, or the rewrite?
12m

It runs on your actual computer.

The agent runs on your computer: your files, your toolchain, your credentials, your dotfiles. Anything you could do at the keyboard, it can do — because it is the same machine. Works on any macOS or Linux host.

Find my latest Cursor session. Watch it periodically, and lmk whenever it's done.
Thought Cursor keeps its CLI sessions under ~/.cursor — newest first…
Read ~/.cursor/cli-config.json
Watch Cursor session running
$ tail -f ~/.cursor/…/agent-transcripts/b41a….jsonl
41 events · last 8s ago
Found it — “Refactor billing” is still going. I'll check in every few minutes and ping you when it lands.

Your sessions never touch our servers.

Your devices pair directly over Iroh. Traffic is end-to-end encrypted and takes the shortest path — on the same network, it never leaves your LAN. Our servers introduce your devices to each other and deliver push notifications. They can't read your sessions; there is nothing to turn over.

Your phone OK Remote Your computer ok host + Pi end-to-end encrypted ok.lol introductions and push no session data

The harness is Pi.

The harness is Pi: minimal, and extensible to exactly your workflow via extensions, skills, and AGENTS.md. Bring your own keys and any provider — Anthropic, OpenAI, Google, local models. If you already use Pi, this is the same Pi, reachable from your pocket.

$ ok agent set ~/.pi/agent
agent dir set to /Users/you/.pi/agent
Commands
Skills
/review
Draft a review from the diff
/changeset
Version bump and release notes
Prompts
/standup
What landed since yesterday
Commands
/init
Write an AGENTS.md for this repo
/compact
Summarize and shrink the context

Not SSH.

A terminal client gives you a shell on a small screen and drops when the network does. OK Remote is built for roaming: sessions live on the host, survive network switches, and the interface is designed for a phone, not shrunk to fit one.

A terminal client
$ ssh you@mac.local
you@mac ~ % cd work/checkout
you@mac checkout % bun test
218 pass 0 fail (41.6s)
you@mac checkout % bun run deploy --staging
deploying…
client_loop: send disconnect: Broken pipe
$ ssh you@mac.local
ssh: connect to host mac.local port 22: Operation timed out
$
OK Remote
Ship staging once the suite is green.
Shell done
$ bun test
218 pass 0 fail (41.6s)
Shell running
$ bun run deploy --staging
uploading assets…
Suite is green. Deploying to staging now — I'll confirm when it's live.

Get started.

curl -fsSL https://ok.lol/install.sh | sh
Download on the App Store
  1. Run that on the computer you want to control. It signs you in, starts the host, and shows a QR code.
  2. Scan it to get the app, then sign in with the same email. Your computer appears.
  3. Turn on notifications, then connect an AI provider with your own key.
  4. Open the folder you want to work in and get started.
  1. Install the app and sign in.
  2. The setup screen shows an install command — run it on the computer you want to control, and sign in with the same email.
  3. Your computer appears. Turn on notifications, then connect an AI provider with your own key.
  4. Open the folder you want to work in and get started.

Already on your phone? Download on the App Store

On your computer:
curl -fsSL https://ok.lol/install.sh | sh
ok up
██████ ██ ███
██ ██ █████
██████ ██ ███
✓ signed in as you@example.com
✓ installed and started via launchd
next: get OK Remote on your phone
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▄▄▄ ▀ ▀███ ▄▄▄▄▄ █
█ █ █ ██▄▀ █▄▀▄▄█ █ █ █
█ █▄▄▄█ ██▀▄ ▄ █▄█ █▄▄▄█ █
█▄▄▄▄▄▄▄█ ▀▄█ █ █▄█▄▄▄▄▄▄▄█
█▄▄█▄ █▄██▄▀█▄▄ ▄█▄▀▀▀▀▀▄█
█▀▄▀█▀▄▄▄▄▄██▄█ ▄▄█ ▀ ▀▀ █
█ ▄ ▄▀ ▄▀ ▄ █▀▄▄▀▄▄▄▄▀██▀▄█
█ ▄▀▄ ▀▄██▀██▀▀ ▄▄▄█▀▄ ▄ █
█▄██▄██▄▄ ▀▄ ▄███ ▄▄▄ █ ██
█ ▄▄▄▄▄ ██▀▄▀▄ ▄▀ █▄█ ███▄█
█ █ █ █ ▄ ▄▀ █ ▄ ▄▄██▀ █
█ █▄▄▄█ █▀█▄ ▀ ██▄▄█▀ ▄ █
█▄▄▄▄▄▄▄█▄██▄▄▄██▄▄▄██▄██▄█
https://ok.lol/app
then open the app and sign in with you@example.com