LinkShellIt works on your computer. You watch from your phone.
Replies stream in word by word; what it read, changed and ran updates live, with a diff for every file. When it needs permission, or wants you to choose, the request comes to your phone: one tap.
Leave your desk. Your agents keep going.
Claude Code, Codex and other coding agents keep running on your computer while you follow them, approve with a tap and cut in from your phone, your watch or the Lock Screen.
Claudeweather-app
Run the tests to check the style change broke nothing
npm test
Running npm test on your computer…
42 tests passed. The agent carries on.
Denied. The agent will try another way.
This is the request your phone gets. Try it.
Approve from the Lock Screen or your wrist
A Live Activity keeps the agent'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.
Live Activities need iOS 16.2 or later, and buttons on the card iOS 17. The watch app needs watchOS 10 or later.
Cut in while it is busy
A message sent mid-turn waits in a queue: reorder it, take it back to rewrite, or send it now, straight into the running turn for Codex and Claude. A turn running on the computer can be stopped from the phone too.
Wherever the session was opened: linkshell claude and linkshell codex in a terminal, a plain claude or codex, the Claude and Codex desktop apps. Carry on from the phone and pick it back up at your desk, with all of its context.
Computer Use, from your phone
Watch it live: ask Codex to use the browser or desktop apps on your computer, right from your phone. Preview its actions live in a floating window while you keep chatting and steering. Drag it aside, enlarge it or collapse it. Currently supports Codex on macOS. How to use it.
Your Mac. In your pocket.
Bring the whole workspace with you. When an agent finishes a change, open the actual desktop to check a browser, work in your editor or handle a dialog. Turn the phone to landscape, go full screen and pinch to zoom. Take over wherever a human touch is needed. Full control requires macOS 13 or later.
- 4K detail. Ready for high refresh.
- A picture up to 3840 pixels wide, with iOS display support up to 120 Hz. Resolution, frame rate and responsiveness depend on devices and network conditions.
- Precision at your fingertips
- Move slowly for precision or swipe across the desktop. Choose trackpad control or direct touch, with right click, scrolling and dragging.
- Your displays and shortcuts, too
- Switch displays, copy, paste and change apps with a tap. Send longer text and your phone's clipboard straight to the computer.
iPhone Duo.
Room to do more.
Open it up and the conversation sits beside the changes or a preview. Fold it and the interface rearranges around the available screen, without leaving the session. A regular iPhone gets a single column with the same controls.
Take a closer look
Choose a pose. Drag to rotate.
- Chat beside your tools
- With enough room, review changes or a preview beside the conversation.
- Aware of the fold
- Adapt to posture and orientation, preserving usable space for input and controls.
- Still at home on iPhone
- Narrower screens use an appropriate single-column layout with familiar controls.
And the rest
- A real terminal on your computer
- Run a dev server, tail logs or use git, with a Ctrl / Esc / Tab / arrow-key bar. It keeps running when you close the app.
- Open localhost on your phone
- Your computer's
localhost:3000right on the phone, hot reload included: no open ports, no shared Wi-Fi. - Forks and worktrees
- Fork a new session from any reply to try another direction, in a new git worktree if you like, away from what you are working on.
- Side conversations
- Ask something without interrupting the turn under way, the agent's own way: Codex's
/side, Claude's and Grok's/btw. Nothing of it enters the session. - Sub-agents and Workflows
- Follow Claude Workflows by phase and open each Agent’s conversation and tool results. Background runs stay above the composer; the header lists all Workflows and sub-agents.
- Slash commands and skills
- Type
/for the agent's commands and your skills./compactand/reviewwork for Codex too. - A full workspace on the Mac
- The Mac app continues conversations, handles approvals and opens terminals and remote desktops, on this Mac or another computer. It also shows token usage by agent, launches at login and comes in light and dark.
- Files and tidy sessions
- Browse the project's files and send photos and files from your phone to the agent. Rename, archive or delete sessions;
claude --resumeshows the new name.
Each agent, as far as it can go
Agents run as the copies already installed and signed in on your computer. LinkShell never touches their accounts or keys.
Codex
Shared: the terminal opened with linkshell codex and your phone are live at once; either can send, interrupt and approve.
Claude Code
Handoff: Claude's own UI at your desk (linkshell claude); a message from the phone takes over, any key on the computer takes it back.
Gemini CLI, GitHub Copilot, OpenCode, Cursor, Grok
Remote sessions: start and continue sessions from the phone over the Agent Client Protocol, with live output, approvals, modes and models.
Any CLI
Terminal: a terminal on the computer, viewed and typed into from the phone.
Three steps to your computer
On Mac or Windows, download the desktop app. The CLI supports macOS / Linux with Node.js 22.13 or newer.
Install and start
Mac · Apple Silicon Mac · Intel
macOS 13 or later: drag it into Applications, open it and sign in, then turn on Screen Recording and Accessibility in its Settings. The app brings its own CLI, Host and Node, and updates them together.
Windows · Installer Windows · ZIP
Windows 10 1809+ / Windows 11 x64: includes CLI, Host and Node, with the same workspace as Mac for conversations, terminals, files and port previews. The window is the same Electron app as on Mac and needs no WebView2 Runtime. Packages are unsigned and may show unknown-publisher or SmartScreen prompts.
On Linux, or if you prefer the command line: install the CLI and run the setup once. It starts LinkShell in the background, takes you to the two permissions the screen needs, and connects your phone.
$ npm i -g linkshell-cli
$ linkshell setupWithout npm, install it with Homebrew or the install script:
$ brew install LiuTianjie/linkshell/linkshell
# or
$ curl -fsSL https://liutianjie.github.io/LinkShell/install.sh | shConnect 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.
# Pro
$ linkshell login
# your own gateway
$ linkshell host --gateway wss://gw.you
$ linkshell pairGet going
Start a session on the phone, or launch agents from your terminal like this to hand them over any time.
$ linkshell claude
$ linkshell codexThe docs have the details.
The agents stay on your computer
Your phone reaches the computer through a gateway. The code and the agents never leave the computer, and the connection is end-to-end encrypted.
- Your computer
- LinkShell on your computer holds every session, keeps its history and decides who is driving right now.
- The gateway
- Gateways only relay ciphertext, the official one and yours alike. Pair once and it stays paired.
- Official or your own
- iTool members use the official gateway: sign in and go. Or run your own with one command or Docker, free.
- Screen and previews
- They go peer to peer when they can; the gateway only introduces the two sides. Where they can't, the screen's video goes through the official TURN relay, still encrypted end to end.
Supporting LinkShell
Buy me a coffee
If LinkShell helps you, you can buy the author a coffee.
Next time you leave your desk, take the session along
Every feature is free, and your own gateway is one command away.