离开电脑，Agent 接着干。Leave your desk. Your agents keep going.

Claude Code、Codex 这些编程 Agent 留在你的电脑上跑。你在手机上看它干活、点一下批准、随时插话，需要时直接看电脑屏幕。代码不离开你的电脑。 Claude Code, Codex and other coding agents keep running on your computer. On your phone you watch them work, approve with a tap, cut in any time, and look at the computer's screen when you need to. Your code never leaves your machine.

已适配 iPhone Duo · 了解折叠体验Now adapted for iPhone Duo · Explore the layout ↗

iPhone 下载Get it for iPhone Android APK 安装电脑端Set up your computer

$npm i -g linkshell-cli

LinkShell 介绍片：手机上看 Agent 干活、批准它的请求、插话、看电脑屏幕

iPhone Duo，
展开你的工作区。iPhone Duo.
Room to do more.

LinkShell 2.3.7 为 iPhone Duo 适配了会话、输入和工具面板。展开时，把对话与改动或预览放在一起；折叠时，界面根据可用区域重新安排内容，继续当前会话。LinkShell 2.3.7 adapts its conversation, composer and tool panels to iPhone Duo. Expanded, see chat beside changes or a preview. Folded, the interface respects the available screen regions while you continue the same session.

LinkShell 夜间模式实际截图：iPhone Duo 展开时的会话与代码改动双栏 / LinkShell dark-mode screenshot: chat and code changes side by side on iPhone Duo — 屏幕内容来自 App 实际运行截图 · iPhone Duo 模拟器。Screen content captured from the running app · iPhone Duo simulator.

对话与工具并排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.
普通 iPhone 同样顺手Still at home on iPhone
较窄的屏幕使用合适的单栏布局，操作保持一致。Narrower screens use an appropriate single-column layout with familiar controls.

它在电脑上干活，你在手机上看着It works on your computer. You watch from your phone.

回复逐字出现；它读了什么、改了什么、跑了什么命令，实时更新，每个文件的改动都能看 diff。它需要权限、或者要你做选择的时候，请求推到手机上，点一下就行。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.

它正忙，你照样能插话Cut in while it is busy

忙的时候发的消息先排队：可以调整顺序、取回重写，或者立即发送，Codex 和 Claude 直接插进当前这一轮。电脑上正在跑的那一轮，手机上也能停。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.

会话在哪儿开的都行：终端里的 linkshell claude 和 linkshell codex，普通的 claude 和 codex，Claude 和 Codex 的桌面 App。手机上接着用，回到电脑前再接回去，上下文一点不丢。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，实时预览Computer Use, from your phone. Watch it live.

在手机上直接让 Codex 操作电脑里的浏览器和桌面应用，操作画面在会话浮窗中实时预览。边看边聊，随时补充要求，不用回到电脑前。小窗可以拖动、放大或收起。（目前支持 macOS 上的 Codex）了解用法。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.

手机端 Computer Use：Codex 会话上方的实时画面浮窗 / Computer Use live preview in a Codex conversation

需要时，直接看电脑屏幕When you need it, the computer's screen

实时画面：手机和电脑能直连时，视频不经过服务器。支持原生播放的 iOS 版本默认请求最高 120 帧，实际帧率随两端显示器、网络、电量和温控调整；连接失败时自动尝试常规视频和加密中继。可以全屏、横屏；切到触控板模式就能接手鼠标和键盘，还有一页一点即发的快捷操作。（macOS，Apple 芯片）Real-time: when the phone and computer can connect directly, video travels through no server. Supported iOS versions request a ceiling of 120 fps for native playback; actual rates depend on both displays, network, power and temperature. Connection failures automatically try standard video and encrypted relay fallback. Full screen or in landscape; switch to trackpad mode to take the mouse and keyboard, with a sheet of one-tap shortcuts. (macOS, Apple silicon)

还有这些And the rest

电脑上的真终端A real terminal on your computer: 开一个终端跑 dev server、看日志、用 git，带 Ctrl、Esc、Tab 和方向键工具栏；关掉 App 也不会中断。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.
在手机上打开 localhostOpen localhost on your phone: 电脑上的 localhost:3000 直接在手机里打开，热更新照常工作，不用暴露端口，也不用同一个 Wi-Fi。Your computer's localhost:3000 right on the phone, hot reload included: no open ports, no shared Wi-Fi.
分叉和 worktreeForks and worktrees: 想换个思路，就从那条回复分叉出一个新会话；可以放进新的 git worktree，不碰你手头的工作区。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.
子 Agent 与工作流Sub-agents and Workflows: 按阶段跟进 Claude Workflow，打开每个 Agent 的对话和工具结果。后台工作流保留在输入框上方；标题旁可查看全部工作流和子 Agent。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.
斜杠命令和 skillsSlash commands and skills: 输入 / 列出 Agent 的命令和你的 skills。/compact、/review 对 Codex 同样可用。Type / for the agent's commands and your skills. /compact and /review work for Codex too.
文件和会话管理Files and tidy sessions: 浏览项目里的文件，把手机里的图片和文件传给 Agent。会话可以重命名、归档、删除，claude --resume 里也能看到新名字。Browse the project's files and send photos and files from your phone to the agent. Rename, archive or delete sessions; claude --resume shows the new name.

每个 Agent 做到它能做到的最好Each agent, as far as it can go

Agent 用你电脑上已经安装、已经登录的那一份。LinkShell 不经手任何 Agent 的账号和密钥。Agents run as the copies already installed and signed in on your computer. LinkShell never touches their accounts or keys.

Codex

多端同步：用 linkshell codex 打开的终端和手机同时在线，任何一端都能发消息、打断、审批。Shared: the terminal opened with linkshell codex and your phone are live at once; either can send, interrupt and approve.

Claude Code

接力：电脑上用原生界面（linkshell claude），手机发消息即接管，电脑按任意键收回。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、GrokGemini CLI, GitHub Copilot, OpenCode, Cursor, Grok

远程会话：通过 Agent Client Protocol 在手机上新建、继续会话，实时输出、审批、切换模式和模型。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

电脑需要 macOS 或 Linux，以及 Node.js 22.13 或更新版本。Your computer needs macOS or Linux and Node.js 22.13 or newer.

1. 安装并启动1. Install and start

安装 CLI，运行一次设置：它在后台启动 LinkShell、带你打开看屏幕需要的两个权限开关，并连上你的手机。Install the CLI and run the setup once: it starts LinkShell in the background, takes you to the two permission switches the screen needs, and connects your phone.

$ npm i -g linkshell-cli
$ linkshell setup

不用 npm 的话，也可以用 Homebrew 或安装脚本：Without npm, install it with Homebrew or the install script:

$ brew install LiuTianjie/linkshell/linkshell
# 或or
$ curl -fsSL https://liutianjie.github.io/LinkShell/install.sh | sh

2. 连接手机2. Connect your phone

Pro：电脑上登录，App 里登录同一账号，电脑自动出现。自建网关：配对一次，扫码即可。Pro: 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 pair

3. 开始工作3. Get going

在手机上新建会话；或者在电脑终端里这样启动 Agent，随时交给手机。Start a session on the phone, or launch agents from your terminal like this to hand them over any time.

$ linkshell claude
$ linkshell codex

更多细节在文档里。The docs have the details.

Agent 留在你的电脑上The agents stay on your computer

电脑上的 LinkShell 持有所有会话，保存历史，决定此刻由谁来驱动。手机通过网关连进来，网关只负责把加密后的数据转过去。LinkShell on your computer holds every session, keeps its history and decides who is driving right now. The phone connects through a gateway that only passes encrypted data along.

网关只转发密文，官方网关和自建网关都看不到你的代码和对话。配对一次长期有效。Gateways only relay ciphertext, the official one and yours alike. Pair once and it stays paired.

Pro 用官方网关，登录即用；也可以用一条命令或 Docker 自建网关，完全免费。屏幕和预览在能直连时点对点传输，网关只负责牵线。Pro uses the official gateway: sign in and go. Or run your own with one command or Docker, free. The screen and previews go peer to peer when they can; the gateway only introduces the two sides.

赞助商Sponsors

感谢以下赞助商对 LinkShell 的支持。Thanks to our sponsors for supporting LinkShell.

请作者喝杯咖啡Buy me a coffee

如果 LinkShell 对你有帮助，可以请作者喝杯咖啡。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.

iPhone 下载Get it for iPhone Android APK 安装电脑端Set up your computer

文档Documentation

LinkShell 分两部分：电脑上的 CLI（托管 Agent 会话），和手机上的 App。下面按顺序走一遍。LinkShell has two parts: the CLI on your computer, which hosts the agent sessions, and the app on your phone. Here it is, in order.

安装Install

电脑需要 macOS 或 Linux，Node.js 22.13 或更新版本（LinkShell 用 Node 自带的 SQLite 保存会话）。You need macOS or Linux and Node.js 22.13 or newer (LinkShell stores sessions in Node's built-in SQLite).

$ npm i -g linkshell-cli
# 或or
$ brew install LiuTianjie/linkshell/linkshell
# 或or
$ curl -fsSL https://liutianjie.github.io/LinkShell/install.sh | sh

要用的 Agent 需要你自己安装并在电脑上登录好（比如 claude、codex login、gemini、copilot login）。手机 App：iPhone · Android APK。Install and sign in to the agents you want to use on the computer yourself (for example claude, codex login, gemini, copilot login). Phone app: iPhone · Android APK.

启动 LinkShellStart LinkShell

$ linkshell host --daemon   # 后台运行run in the background
$ linkshell host status     # Agent、会话、网关状态agents, sessions, gateway
$ linkshell host stop

host 用你登录 shell 的环境变量启动 Agent，所以 PATH、代理、API key 这些和在终端里一样。会话和历史保存在 ~/.linkshell，重启电脑不需要重新配对。The host starts agents with your login shell's environment, so PATH, proxies and API keys match your terminal. Sessions and history live in ~/.linkshell; restarting the computer doesn't need a new pairing.

连接手机Connect a phone

Pro：官方网关Pro: the official gateway

$ linkshell login
$ linkshell host stop && linkshell host --daemon

在 App 里用同一个账号登录，电脑会自动出现在「电脑」页，不需要扫码。了解 Pro。Sign in to the app with the same account and the computer shows up under Computers; no QR code needed. About Pro.

自建网关：配对Your own gateway: pairing

$ linkshell host --gateway wss://gw.example.com --daemon
$ linkshell pair

终端里会出现二维码和 6 位配对码。在 App 的「电脑 → 添加电脑」里扫码或输入配对码。网关地址会保存下来，之后启动 host 不用再写 --gateway；--gateway off 可以关掉。The terminal shows a QR code and a 6-digit code. In the app, go to Computers → Add computer and scan it or type the code. The gateway is remembered, so later starts don't need --gateway; --gateway off turns it off.

自建网关Self-host a gateway

网关只转发加密数据，不需要多少资源。任选一种：A gateway only relays encrypted data and needs very little. Pick one:

# 在服务器上用 CLIwith the CLI on a server
$ linkshell gateway --port 8787 --daemon
# 或 Dockeror Docker
$ docker run -d --name linkshell-gateway -p 8787:8787 \
    -v linkshell-gateway:/data nickname4th/linkshell-gateway

公网上请在前面加一层 HTTPS 反向代理（Caddy、Nginx 都行），然后用 wss://你的域名。只在家里用的话，可以直接把网关跑在这台电脑上，用 ws://局域网IP:8787。On the internet, put an HTTPS reverse proxy in front (Caddy or Nginx) and use wss://your-domain. For home use only, you can run the gateway on the computer itself and use ws://LAN-IP:8787.

在电脑终端里用From your terminal

$ linkshell claude [参数args]   # Claude Code，可交给手机Claude Code, hand-off ready
$ linkshell codex [参数args]    # Codex，和手机同步Codex, shared with the phone

参数原样传给 Agent（比如 linkshell claude --resume <id>）。Claude 在电脑上运行时，手机能实时看到进度；在手机上发消息就接管，终端会显示「已由手机接管」，按任意键收回。Arguments pass straight through (for example linkshell claude --resume <id>). While Claude runs at your desk the phone follows along live; sending from the phone takes over, the terminal says so, and any key takes it back.

Claude 在收到第一条消息之前不会保存会话，所以一个还没发过消息的会话不能交给手机。Claude doesn't save a session until its first message, so a session with no messages yet can't be handed to the phone.

在手机上用On your phone

新建会话：选 Agent 和项目目录，直接开始。New session: pick an agent and a project folder and go.
回答提问：Codex（含 Desktop 异步提问）、Claude、Cursor 和 Grok 的结构化问题会显示「需要用户输入」，可在手机卡片中作答或跳过。Cursor 支持选择，其他类型按 Agent 提供的能力支持文字回答。Answer questions: Codex (including Desktop asynchronous questions), Claude, Cursor and Grok show when input is needed. Answer or skip from the phone's question card. Cursor supports choices; text answers depend on the agent.
忙的时候发消息：消息在输入框上方排队，可以调整顺序、取回编辑、立即发送（Codex 和 Claude 直接插进当前这一轮，其他 Agent 先停下当前这一轮）；停止时排队的文字会放回输入框。Messages while busy: they queue above the composer, where you can reorder them, take one back to edit, or send it now (into the running turn for Codex and Claude; other agents stop the turn first). Stopping puts queued text back in the composer.
分叉与 worktree：每条回复下方可以「从这里分叉」，会话菜单里可以分叉整个会话；新建会话或分叉时可以选择放进新的 git worktree（在 ~/.linkshell/worktrees/ 下，独立分支），删除会话时没有改动的 worktree 会一起清掉。Fork and worktrees: fork from under any reply, or the whole session from its menu; a new session or a fork can go into a new git worktree (under ~/.linkshell/worktrees/, on its own branch). A worktree without changes is removed with its session.
命令面板：输入 /、点击输入框的命令按钮，或从会话菜单打开命令面板，搜索 Agent 的命令与 skills；草稿会保留。Command palette: type /, tap the composer’s command button, or choose Commands from the session menu. Search commands and skills without losing your draft.
持续目标：Codex 和 Claude Code 支持 /goal，也可从菜单进入目标页面。Codex 可设置预算、暂停和继续；Claude 可设置或清除完成条件。需电脑上的 Agent 支持相应能力。Persistent goals: use /goal with Codex or Claude Code, or open the goal screen from the menu. Codex supports token budgets, pause and resume; Claude supports setting and clearing completion conditions. Requires support from the installed agent.
后台任务：/tasks 或标题旁的入口可查看回复结束后仍运行的命令、输出和退出码。Codex 支持单任务停止；Claude Bash / Monitor 目前只支持查看，停止请在电脑端操作。Background tasks: /tasks or the session header shows commands that keep running after a reply, their output and exit codes. Stop individual Codex tasks; Claude Bash / Monitor tasks are viewable, with stopping handled on the computer.
屏幕适配：iPhone Duo 和普通 iPhone 都会根据可用空间调整聊天、输入框和操作区。Adaptive layouts: the conversation, composer and controls adapt to the available space on iPhone Duo and standard iPhones.
工作流、子 Agent 与文件：会话标题旁的按钮列出工作流和子 Agent；输入框上方可回到后台工作流；会话和终端的菜单里可以浏览项目文件。Workflows, sub-agents and files: the button beside a session's title lists its Workflows and sub-agents; return to background runs above the composer, and browse project files from a session's or a terminal's menu.
设置：输入框下方可以换模型、思考强度、权限模式（取决于 Agent 提供了哪些）。Settings: under the composer, change model, effort and permission mode (whatever the agent offers).
整理：长按会话可以重命名、归档、删除；归档的会话在首页底部。不再使用的电脑，在账号页的「我的电脑」里长按移除。Tidying: long-press a session to rename, archive or delete it; archived sessions are at the bottom of Home. A computer you no longer use: long-press it under My computers on the account page.
终端、预览、屏幕：在「电脑」页开终端、打开本地端口（可全屏），或看电脑屏幕，并用触控板和键盘控制它。屏幕工具条上有快捷操作（复制、粘贴、切换应用、调度中心、截图、F 键，也可以添加自己的）和「发送文字」（写好一段再发，可以带上手机剪贴板）。需要 Apple 芯片的 Mac；两项权限由 linkshell setup 带你打开，单独设置用 linkshell screen。Terminal, preview, screen: from Computers, open a terminal, open a local port (full screen available), or view the screen and control it with a trackpad and keyboard. The screen's toolbar has one-tap shortcuts (copy, paste, switch app, Mission Control, screenshots, F-keys, and your own) and a text box to write in and send, with the phone's clipboard. Needs a Mac with Apple silicon; linkshell setup takes you through its two permissions, linkshell screen does just that part.

远程桌面的画面与连接Remote screen quality and connection

Mac 使用硬件编码的实时视频，支持原生播放的 iOS 版本默认用原生接收与 Metal 显示，保留同一套悬浮工具栏、手势和键盘。最高 120 帧是请求上限，实际效果取决于电脑与手机的显示器、网络、电量和温控。Android 和浏览器使用常规视频播放器。The Mac sends hardware-encoded real-time video. Supported iOS versions use native reception and Metal display with the same floating controls, gestures and keyboard. The 120 fps ceiling is a request; actual performance depends on both displays, network, power and temperature. Android and browsers use the standard video player.

在「连接信息」中选择流畅 1280、标准 1920、高清 2560 或原生宽度（最高 3840，不超过源屏幕）。直连失败时 iOS 先尝试常规视频，再转入加密中继兼容播放；兼容方式自动降低分辨率与帧率，不受这个清晰度选项控制。重新进入或重试会重新尝试首选路径。原生播放需要包含该功能的 iOS 安装包。Connection info offers widths of 1280, 1920, 2560 or native (up to 3840, bounded by the source display). If direct video fails, iOS tries standard video and then encrypted relay playback. Compatibility playback adapts resolution and frame rate independently of this width choice. Reopening or retrying starts with the preferred path again. Native playback requires an iOS app binary that includes it.

稳定 120 fps、稳定 4K/60 和真机弱网效果仍待验证。完整技术链路、回退规则和已知问题见远程桌面架构与链路图。Sustained 120 fps, stable 4K/60 and real-device weak-network performance remain unproven. See the remote-desktop architecture and diagrams for the paths, fallback rules and known issues.

iPhone Duo 与自适应布局iPhone Duo and adaptive layouts

从 App 2.3.7 起，LinkShell 支持 iPhone Duo 的可用区域和折叠信息。宽度足够时，打开「改动」或「预览」可以与对话并排；折叠区域会参与内容与操作区的布局计算。较窄的窗口与普通 iPhone 使用单栏布局。布局变化时保留会话和工具面板的状态。From app 2.3.7, LinkShell uses iPhone Duo’s available regions and fold information. With sufficient width, Changes or Preview can sit beside the conversation. Fold regions inform the layout of content and controls; narrower windows and standard iPhones use one column. Session and tool-panel state is preserved as the layout changes.

Duo 布局已通过模拟器交互验证；实际显示取决于系统报告的尺寸和姿态。Duo layouts have been checked in the simulator; actual presentation depends on the size and posture reported by the system.

在手机上用 Computer UseUse Computer Use from your phone

在手机会话里告诉 Codex 你想做什么，让它操作电脑上的浏览器或桌面应用。操作画面会在浮窗中实时预览，你可以边看边补充要求，继续推进任务。Tell Codex what you want done in the phone conversation and let it work in your computer's browser or desktop apps. Watch its actions live in a floating preview and keep giving instructions as it works.

边聊边看：小窗不随聊天滚动，可以拖到一边、点击放大，也可以收起成图标或关闭；关闭后在会话菜单点「显示电脑画面」恢复。Watch while chatting: the preview stays in place as you scroll. Drag it aside, tap to enlarge it, collapse it to an icon or close it. Reopen it with “Show computer preview” in the session menu.
回来接着看：回合结束后保留最后画面，重新进入会话会恢复预览状态。Pick up where you left off: the last frame stays after the turn, and reopening the session restores the preview state.

目前支持 macOS 上的 Codex，需已配置兼容的 Computer Use 工具，并使用支持此功能的电脑端和手机 App。请在 Mac 上允许 LinkShell 录制屏幕，可运行 linkshell screen 完成设置。Currently supports Codex on macOS with compatible Computer Use tools configured, and versions of the computer and phone apps that support this feature. Allow LinkShell to record the Mac's screen; run linkshell screen to set it up.

命令一览Commands

linkshell setup: 首次设置：启动 LinkShell、打开屏幕的两项权限、连接手机First-time setup: start LinkShell, the screen's two permissions, connect your phone
linkshell host [--daemon] [--gateway <url>]: 启动 LinkShell；status、stopStart LinkShell; status, stop
linkshell pair: 通过网关配对手机Pair a phone through the gateway
linkshell devices: 列出已配对的手机；remove 移除一台List paired phones; remove unpairs one
linkshell screen: 设置看屏幕和控制屏幕（macOS 的两项权限）Set up watching and controlling the screen (the two macOS permissions)
linkshell login / logout: Pro 账号（官方网关）Pro account (official gateway)
linkshell claude / codex: 在终端里启动 Agent，可与手机共享Start an agent in your terminal, shared with the phone
linkshell gateway [--port] [--daemon]: 运行自己的网关；status、stopRun your own gateway; status, stop
linkshell doctor: 检查环境和连接Check the environment and connectivity
linkshell upgrade: 升级到最新版Upgrade to the latest version

常见问题FAQ

App 显示「电脑暂时连不上」The app says the computer can't be reached

确认电脑没睡眠、linkshell host status 里网关是已连接，然后运行 linkshell doctor。连接恢复后 App 会自动重连。Check the computer is awake and linkshell host status shows the gateway connected, then run linkshell doctor. The app reconnects on its own once it's back.

Agent 显示「未登录」An agent shows "not logged in"

在电脑终端里给那个 Agent 登录一次（claude 里的 /login、codex login、copilot login 等），LinkShell 用的就是那份登录。Sign in to that agent once in a terminal on the computer (/login in claude, codex login, copilot login…); LinkShell uses that sign-in.

从 1.x 升级Upgrading from 1.x

2.0 的 App 和电脑端协议都换了，需要两边一起升级，再重新配对一次。1.x 的 App 和 linkshell start 已不再支持。2.0 changed both the app and the computer side, so upgrade both and pair again. The 1.x app and linkshell start are no longer supported.