Codex, from your phone.

Codex keeps running on your computer, with the terminal and the phone live together. Follow its progress, approve requests and steer the running turn from iPhone, Android or Apple Watch.

Get it for iPhone Android APK Set up your computer

Codexapi-servernow

Run the tests to check the API change broke nothing

Needs your approval

pnpm test

Running pnpm test on your computer… 36 tests passed. Codex carries on. Denied. Codex will try another way.

This is the request your phone gets. Try it.

Terminal and phone, live together

The terminal opened with linkshell codex and your phone share one session: either side can send, interrupt and approve. Sessions from a plain codex or the Codex desktop app can be followed too.

$ linkshell codex
# arguments pass through to codex

Computer Use, from your phone

Ask Codex to use the browser or desktop apps on your computer, right from your phone, and watch it live in a floating window while you keep chatting and steering. Drag it aside, enlarge it or collapse it. (Codex on macOS for now.)

Computer Use live preview in a Codex conversation

Approve from the Lock Screen or your wrist

A Live Activity keeps Codex's progress on the Lock Screen and in the Dynamic Island; when it asks for permission, the card carries Deny and Allow. On Apple Watch you can follow sessions, answer requests and send a short reply.

A LinkShell Live Activity on the iPhone Lock Screen with a pending request and Deny and Allow buttons

Live Activities need iOS 16.2 or later, and buttons on the card iOS 17. The watch app needs watchOS 10 or later.

Codex's own tools, on the phone

Cut in while it is busy: Messages sent mid-turn wait in a queue: reorder them, take one back, or send it now, straight into the running turn. Stop a turn from the phone.
Side questions with /side: A read-only temporary fork; nothing of it enters the session.
Persistent goals: Set, pause, resume or clear a /goal, with a token budget.
Slash commands and skills: /compact, /review, /init and your skills, from the phone.
Background commands: See their status and output, and stop one task.
Questions and plan mode: Answer Codex's questions, the desktop app's asynchronous ones included; plan mode is a setting on the phone.
Your sign-in, as it is: ChatGPT sign-in, an API key or a custom provider, including one managed by CC Switch.

Your code and Codex stay on your computer

End-to-end encrypted: Keys are agreed with X25519 and every frame is sealed with XChaCha20-Poly1305. The gateway relays ciphertext only.
Your own Codex sign-in: Codex runs as your user with its own sign-in. LinkShell never handles your accounts or API keys.
No shared Wi-Fi needed: The phone reaches the computer through a gateway with no open ports: the official one or your own.

Three steps

Install on your computer

On Mac or Windows, the desktop app brings its own CLI. On macOS or Linux you can install the CLI instead, with Node.js 22.13 or newer.

Download the desktop app

$ npm i -g linkshell-cli
# or
$ brew install LiuTianjie/linkshell/linkshell
$ linkshell setup

Connect your phone

iTool members: sign in on the computer and in the app with the same account; the computer just appears. Own gateway: pair once with a QR code.

# iTool
$ linkshell login
# your own gateway
$ docker run -d -p 8787:8787 -v linkshell-gateway:/data nickname4th/linkshell-gateway
$ linkshell host --gateway wss://gw.you
$ linkshell pair

Get going

$ linkshell codex

The docs have the details.

Pricing

Free

¥0

Every feature, with your own gateway

All agents, handoff, approvals, terminal, previews
Self-hosted gateway: one command or Docker

Self-hosting guide

iTool membership

¥9.9/mo

US$3.19 a month by international card

The official gateway, no server to run
Sign in with one account, no QR codes
Or ¥99 a year with every iTool product

Get iTool membership ↗

Questions

Does my phone need the same Wi-Fi as the computer?

No. The phone reaches the computer through a gateway, over cellular too, with no open ports.

Does LinkShell see my Codex sign-in or API key?

No. Codex runs with the sign-in already on your computer; LinkShell never handles accounts or keys.

Can Codex use my computer while I watch from the phone?

Yes. With Computer Use, Codex works the browser and desktop apps on your computer while a floating window shows it live. Codex on macOS for now.

Can I approve a request without opening the app?

Yes. The Live Activity on the iPhone Lock Screen carries Deny and Allow (iOS 17 or later), and Apple Watch can answer requests too (watchOS 10 or later).

What does it cost?

Every feature is free with your own gateway (one command or Docker). To skip the server, an iTool membership adds the official gateway from ¥9.9 a month, or US$3.19 a month by international card.

Next time you leave your desk, Codex keeps going

Using Claude Code too? See it on the phone.

Get it for iPhone Android APK Set up your computer