webssh

For Claude Code · Codex · your shell 为 Claude Code · Codex · 你的 Shell 而做

Leave the desk.Keep your agents. 人离开电脑,agent 照样听你的。

webssh turns the Claude Code and Codex sessions running on your Mac into a chat app on your phone. See what they did, answer when they ask, speak instead of typing. It runs on your own Mac, and nothing passes through a server of ours. webssh 把 Mac 上正在运行的 Claude Code、Codex 会话,变成手机里的一个聊天应用。看它做了什么,在它提问时作答,用说的代替打字。它跑在你自己的 Mac 上,中间不经过任何属于我们的服务器。

See what it does看看它能做什么 How it works它是怎么工作的

The chat view. Session and messages are examples. 聊天界面。会话与消息均为示例。
0

servers of ours between you and your Mac 台我们的服务器夹在你和 Mac 之间

0.2–0.5s

from “Done” to text, for a one-minute dictation1 一分钟的口述,点“完成”后出字的时间1

1tap下

to answer when an agent asks for permission 点击,回答 agent 的一次权限请求

01 · The idea01 · 想法

A conversation, not a terminal squeezed into a browser. 是对话,不是塞进浏览器的终端。

The chat is built from the agent's own record on your Mac, not scraped off its screen. So text wraps to your phone, Markdown reads like Markdown, and a long run of tool calls folds into one line you can open. 聊天内容来自 agent 自己写在 Mac 上的记录,而不是从屏幕上抠下来的。所以文字按手机宽度换行,Markdown 就是 Markdown,一长串工具调用折成一行,想看再点开。

  • The remarks an agent makes between steps, as it makes them. agent 在步骤之间说的话,随说随到。
  • “Ran 4 commands, read 2 files, made 1 edit · 1 failed” instead of forty rows. 一行“运行 4 条命令、读 2 个文件、改 1 处 · 1 个失败”,而不是四十行。
  • The real terminal is one tap away when you want it. 想看原样的终端,点一下就到。

02 · What you get02 · 你得到什么

Everything you do at the desk, minus the desk. 在电脑前能做的,离开电脑也能做。

A

Answer from anywhere人在哪都能回答

When an agent stops to ask, a notification tells you what it asks. Permission prompts and multiple-choice questions become buttons. On desktop and Android you can answer from the notification itself. agent 停下来问你时,通知里直接写着它问什么。权限请求和多选题变成按钮。在电脑和 Android 上,通知里就能回答。

B

Speak, don't type用说的,不用打字

Dictation is transcribed on your own Mac with Whisper. The recording travels while you speak and the text appears as you go, so there is no wait at the end. Chinese, English, or both in one sentence. 口述在你自己的 Mac 上用 Whisper 转写。录音边说边传,文字边说边出,说完不用等。中文、英文、中英夹杂都行。

C

Files, both ways文件有来有回

Attach photos, screenshots and files from the phone; the agent gets them as paths it can open. Browse and download what it produced. Uploads travel in small pieces and pick up where they stopped. 从手机附上照片、截图和文件,agent 拿到的是可以直接打开的路径。它生成的文件可以浏览和下载。上传是分片的,断了从断点接着传。

D

Every session, one list所有会话,一张列表

Dozens of agents at a glance: which are working, which wait for you, which have finished. Search inside every conversation and pin the ones that matter. Idle sessions are parked to free the Mac and come back in one tap. 几十个 agent 一眼看清:谁在干活,谁在等你,谁已完成。可以搜索所有对话的内容,把重要的置顶。闲置的会话自动停放以释放 Mac 的资源,点一下就恢复。

E

It keeps going断了也不停

Sessions live in tmux on your Mac. Close the browser, lose signal, restart the server: the work continues, and you come back to the same process. After the Mac restarts, sessions return with the conversations they had. 会话跑在 Mac 的 tmux 里。关掉浏览器、信号断了、服务重启,活儿都不会停,回来接上的还是同一个进程。Mac 重启之后,会话带着各自的对话回来。

F

Know before you run out额度见底前先知道

Model, effort, context left and usage limits sit in a bar above the chat; tap to change model or effort. A warning arrives when the weekly limit passes 80, 90 and 95 percent. 模型、推理强度、剩余上下文和用量额度都在聊天上方的状态栏里,点一下就能换模型或强度。周额度用到 80%、90%、95% 时会提醒你。

03 · How it works03 · 怎么工作

One server, and it is yours. 只有一台服务器,而且是你的。

In your hand在你手里

Phone · iPad · laptop手机 · iPad · 电脑

A web app on your Home Screen. No App Store, and the same app on every screen you own. 一个添加到主屏幕的网页应用。不经过 App Store,你的每块屏幕上都是同一个应用。

In between两者之间

A private link一条私有通道

Tailscale, or your own Cloudflare Tunnel behind Cloudflare Access. No relay of ours. Tailscale,或你自己的 Cloudflare Tunnel 加 Cloudflare Access。没有我们的中转。

On your desk在你桌上

Your Mac你的 Mac

webssh→tmux→Claude CodeCodexshell

Whisper runs here too: your voice is transcribed on this machine. Whisper 也跑在这里:你的声音就在这台机器上转写。

webssh is a small server on your Mac and a web app you add to your Home Screen. There is no account with us and nothing of ours in the middle: we could not read your sessions if we wanted to. webssh 就是跑在你 Mac 上的一个小服务,加上一个添加到主屏幕的网页应用。不用在我们这里注册账号,中间也没有任何属于我们的东西:我们想看也看不到你的会话。

04 · Yours04 · 归你所有

What we can see of your work: nothing. 我们能看到你的什么:什么都看不到。

Code and conversations代码和对话
They live on your Mac. webssh reads the agents' own records, never changes them, and shows them only to devices you have signed in. 它们存在你的 Mac 上。webssh 只读取 agent 自己的记录,从不改动,并且只显示给你登录过的设备。
Your voice你的声音
Audio is transcribed on your Mac, then deleted. It is never logged. 音频在你的 Mac 上转写,随后删除,不进任何日志。
The way in进入的通道
Your tailnet, or your own tunnel behind Cloudflare Access plus the app's own sign-in. Two locks, both yours. 你的 tailnet,或你自己的隧道:前面是 Cloudflare Access,后面还有应用自己的登录。两把锁,都在你手里。
Notifications通知
Delivered by Apple's or Google's push service, encrypted for your device. You can keep the question text out of them. 经苹果或谷歌的推送服务送达,内容为你的设备加密。也可以选择不在通知里带问题内容。

05 · Where it stands05 · 现在到哪一步了

In daily use. A public release is planned. 每天都在用。公开版本在计划中。

webssh is used by its author every day, from an iPhone, an iPad and whatever computer is nearby. It is not for sale yet. webssh 目前由作者本人每天在用,在 iPhone、iPad 和手边任意一台电脑上。现在还没有开始出售。

  • What it needs需要什么
  • A Mac that stays on一台保持开机的 Mac
  • tmux
  • Claude Code or CodexClaude Code 或 Codex
  • Any modern browser (added to the Home Screen on iPhone and iPad) 任意现代浏览器(iPhone、iPad 上添加到主屏幕)

67 automated end-to-end checks run against a real browser and real sessions before every change, plus runs with the real agents. 项端到端自动测试,每次改动前都在真实浏览器和真实会话上跑一遍,另有用真实 agent 做的测试。