v1.21.5 · Apache-2.0 开源 · 自托管

AI 在跑,
你却被锁在椅子上

派完活就把手机收起来。会话活在服务器上,断网它继续跑;跑完或要你拍板时,推送叫你回来。

演示站不用装、不用配机器 —— 真的前端,模拟的 agent。

用系统输入法整段派活给 Claude Code
锁屏推送:Claude 等待你的输入
重连后输出已补齐,Git 面板显示提交
1个
二进制装完就是完整产品
300秒
配对码有效期,用完即焚
4种
AI 工具完成即推送
0行
你的代码离开过自己的机器
How it works

会话活在服务器上,
手机只是那块屏幕

收起手机,任务照跑

09:12 在地铁口派出一个重构任务,然后把手机装回兜里。进隧道、切出去回微信、锁屏——服务器上的活一秒没停。

  • 会话真身是服务端 tmux,手机断开只是「屏幕拔了」
  • 按序号记账,重连只补你错过的那一段,不重发
  • 长输出无上限滚动,输入行始终钉在底部
claude-refactor

kimi-docs

build-server

需要你时,它会来找你

10:05 手机震了一下:Claude 跑完了一轮,在等你回答要不要应用这个补丁。你在锁屏上看清了它问什么,解锁点进去回了个 y,锁屏,继续走路。

  • App 没打开、手机锁着也能收到
  • 正在看的那个会话不推送,不打扰你
  • 国内网络可走企微 / 飞书 webhook,不依赖 FCM
POCKETSHELL · 现在
Claude 等待你的输入
claude-refactor:是否应用这个补丁?(y/n)

在手机上,是真的能用

12:30 到工位打开电脑,活已经干完了——因为该拍板的地方,你在路上就都拍完了。

  • 笔记本级全键盘:F1–F12、方向键、sticky 修饰键
  • 键位三选一 —— 也可以把键放大一倍,符号一滑就出
  • 用系统输入法写完一整段中文需求,一次注入
  • 文件树 / 代码编辑 / Markdown 与图片预览 / Git diff
Watch it

四十秒,
从派活到收答案

一条连续录制:派完活收起手机,任务跑完它自己叫你回来。

  1. 解锁手机,在桌面点开 PocketShell
  2. 新建一个 tmux 会话
  3. 从快捷指令启动 Claude Code
  4. 用系统输入法写完一整段中文需求,一次发出去
  5. 直接回桌面锁屏——没什么好守着的
  6. 锁屏亮起:任务跑完了
  7. 点通知回到那个会话,读 Claude 的回答
Features

一个二进制,装完就齐

前端内嵌、同端口服务。下载、运行、配对——没有第四步。

▣

多会话终端

机器上所有 tmux 会话都在列表里,包括不是它开的。三态灯 + 末行预览,一眼看出哪个在跑、哪个卡着等你。

⌨

自定义全键盘

手机敲终端不再是酷刑。键位三选一 —— 完整笔记本布局,或者更大的键、符号一滑就出 —— 外加智能命令联想、快捷指令多设备同步。

🗀

文件与 Git

不用退回终端敲 cat。目录树、代码编辑、Markdown 与图片预览、工作区 diff、上传下载。

🔔

完成即推送

Claude Code / Codex / opencode / Kimi CLI 的完成钩子自动接线,按工具独立开关,不用你写配置。

🔒

端到端加密

每次连接一次完整 Noise IK 握手。中间的隧道和反代只经手密文,看不见你的终端。

◎

加到主屏就是 App

七套主题外加自行导入的 Ghostty 配色、五套等宽字体、中英双语、应用内一键更新、AI 上下文用量实时可见。

Why not SSH

手机上开个 SSH 也能连,
但那不是同一件事

手机 SSH 客户端
PocketShell
断网之后
连接断开,得手动重连再 attach
任务不停,回来自动接上
错过的输出
要么全丢,要么整屏重刷
按序号只补你错过的那段
Agent 跑完了
没人告诉你,只能自己去看
推送直达锁屏,点开就是那个会话
打字
手机键盘,没有 F 键和方向键
笔记本级全键盘 + 输入法整段注入
看文件 / diff
回终端敲命令
文件树、预览、diff 面板

PocketShell 不替代 SSH——它假设你已经有 tmux 和一台常开的机器,只是把「人不在场那段」补上。

三分钟,跑起来

宿主机只要有 tmux 和 git。Linux / macOS 都行。不用域名、不用配反代 —— 一条命令就能拿到真 HTTPS 地址。

1

一行安装

自动认平台、校验 SHA256,装完直接把下一条命令连路径一起打出来。

2

注册成服务

开机自启,第一次安装会直接把配对串打出来。

3

拿一个公网地址

没有域名?tunnel setup 走 Tailscale Funnel 给你一个 —— 除两次浏览器授权外全自动。已有域名就跳过这步。

4

手机配对

浏览器打开、粘贴、加到主屏幕,完事。

terminal
# 安装 —— 它会把下一条命令连正确路径一起打出来
$ curl -fsSL https://raw.githubusercontent.com/Big-Pony/pocketshell/main/install.sh | sh

# 没有域名:先填占位地址,下一步会自动替换
$ sudo pocketshell-agent install \
    --advertise ws://127.0.0.1:8722 --name my-server
$ sudo pocketshell-agent tunnel setup

# 已有域名?只要这一条(macOS 无需 sudo)
$ pocketshell-agent install \
    --advertise wss://your.domain --name my-mac
Security

你的机器,你的密钥

所有安全性压在「谁能配对」这一个点上——所以这个点被层层把守。

Noise IK 握手

双向认证 + 前向保密。没登记过的设备,握手这关就过不去。

一次性配对码

300 秒过期、限次、限速。爆破会被锁。

吊销即刻生效

命令行一句话踢掉一台设备,在线连接几秒内断开,推送订阅一并清除。

全程留痕

握手、配对、吊销、锁定都结构化落盘,随时可查——但不记录你的命令和终端内容。

为了一天 15 分钟的活,
你背了一整天电脑

派活、答一句 y、看眼 diff、让它重试——真正要你在场的就这些。剩下的时间,那台机器自己会跑。