TermPilot让同一条终端会话持续可达

面向长期任务的本地优先终端会话连续性工具。电脑继续运行原会话，手机继续接入同一条上下文。

快速开始

部署指南

产品概览

CLI 参考

同一条受管理会话

桌面和移动端接入的是同一条会话，不需要重新开一个 shell。

本地优先的数据归属

会话标题、cwd、状态详情和终端输出保留在 agent 所在电脑，relay 只保留最小元数据。

relay 与 agent 分层

relay 负责入口、配对、授权和加密路由；agent 负责本地 tmux 会话和输出同步。

面向长期任务

适合 Claude Code、部署、迁移、脚本执行等需要离开桌面后继续查看和轻控制的任务。

移动端终端工作区

手机端提供终端键盘、快速输入、快捷控制和专注模式，适合轻量查看与补命令。

产品定位

TermPilot 面向的是一个很明确的使用场景：

一条终端任务已经在你的电脑上运行，而你希望在离开桌面之后，继续从手机接入这条原会话。

它围绕同一条长期任务在多端之间持续可达来设计。

当前产品形态

发行

统一 CLI

@fengye404/termpilot 统一提供 relay、agent、配对和会话管理命令。

会话

tmux 作为当前后端

agent 管理本地 tmux 会话，当前支持普通 shell 会话和托管命令会话。

同步

端侧输出回放

输出同步由 agent 提供，页面回到前台后会主动补齐缺失输出，保持当前会话尽快追平。

安全

设备级配对

浏览器通过一次性配对码、访问令牌和设备指纹与 agent 建立绑定。

部署

单机长期运行

relay 默认使用 SQLite 持久化最小元数据，适合一条命令启动和单机长期运行。

典型路径

在服务器或可访问机器上启动 relay
在你的电脑上启动 agent
手机浏览器输入一次性配对码
用 termpilot run -- <command> 或 termpilot create 启动受管理会话
在桌面和手机之间继续接入同一条上下文

文档地图

产品概览理解它解决什么问题、适合什么任务，以及当前的产品边界。快速开始用当前主路径完成 relay、agent、配对和第一条受管理会话。部署指南选择 npm CLI 或 Docker 部署 relay，并配置公网入口、SQLite 和反向代理。Agent 运维管理 agent、配对、授权、本地状态目录、日志和会话治理。故障排查按症状定位“打不开页面、配对失败、看不到设备、看不到会话”等常见问题。CLI 参考查看命令面、退出语义、配对命令和会话管理入口。安全设计查看数据归属、密钥绑定、加密信封和 relay 的安全职责边界。代码架构理解仓库结构、运行时数据流、状态持久化和当前架构取舍。协议说明查看配对流程、WebSocket 消息、加密信封和 HTTP 接口。持续改进计划了解围绕现有主路径的稳定性、体验、运维和安全增强方向。